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Introduction 


The IBM PC and compatibles form the largest portion of the computer market, and likely will continue to do so for 
the remainder of the decade. The MS-DOS operating system for IBM PCs is the most popular ever developed, and the 
large sales of the recently released MS-DOS 5.0 prove that it will remain so for some time, Because the architecture 
of the IBM PC allows programs to provide services to other programs via software interrupts, and MS-DOS provides 
a mechanism for retaining programs in memory in order to continue providing such services, hundreds of software 
vendors have extended the basic set of services in often incompatible ways. As more programs provide additional in- 
terrupt calls, the probability of conflict between different programs increases. 

Over the years, literally dozens of books have been written which include reference sections detailing the ROM 
BIOS services built into IBM PCs, and the additional services provided by MS-DOS. Some also cover the Expanded 
Memory Specification (EMS) services, but few go beyond that. 

Thus, programmers have been forced to accumulate information about additional interrupt services piecemeal— 
one document covering one specification, another a second, and an electronic bulletin-board message a third. With 
such a collection of sources, it can be quite difficult to determine that two programs are incompatible because they ex~ 
pect different services from the same interrupt call, 

This book is a comprehensive collection of the varied calls which have been implemented by various programs 
over the years, It includes all calls for some 25 major application programming interfaces and dozens of resident utili- 
ties (including shareware programs and undocumented interfaces), as well as the usual coverage of BIOS and MS- 
DOS services. Because of the number of different calls covered (nearly 2800), there is no room for detailed 
discussions or sample code. 

PC Interrupts is designed to be a reference, not a tutorial. It will form a companion to any texts covering MS-DOS 
or the IBM PC which you may already own. In addition to its main purpose as a programming reference, you may 
also find it valuable as a tool to help you track down undesirable interactions between various programs running on 
the same PC. 

The material presupposes some familiarity with programming using software interrupts, although there is no need 
to know a particular programming language. Software interrupts may be invoked from most high-level languages for 
the IBM PC as well as assembler, and most books on those languages cover interrupts at least briefly. 


Interrupts and the ’86 CPU Family 

While this book is intended as a reference rather than as a tutorial, so many different partial listings of interrupt usage 
have been published, each using its own vocabulary and assumptions, that it is necessary to take a few pages up front 
to present an overview of the subject. This section briefly describes the basic interrupt concept as implemented in the 
Intel 80x86 family of processor. 

The Intel 80x86 family of processors all provide the capability of servicing a maximum of 256 distinct interrupt 
actions, by means of a table of 256 four-byte interrupt vectors. This table occupies the first 1024 bytes of the RAM 
address space. Each vector consists of a 32-bit address, in standard Segment:Offset format, of the routine that will be 
called automatically in response to the corresponding interrupt. 

The interrupt request that triggers the calling of such a routine can be generated in any of three ways: it can be in- 
ternally generated by the processor chip itself, it can be created by an external interrupt request signal (called INTR 
by Intel), or it can be the result of a software interrupt (INT) instruction. 

The original members of this processor family, the 8086 and 8088, dedicated only the first five interrupt vectors 
(INT 00h through INT 04h) to serving internally generated interrupts, although Intel clearly warned all users of the 
chips that the remaining 27 of the first 32 interrupts were reserved for future use. IBM chose to ignore that warning in 
the design of the PC, and assigned INT 05h to the print-screen action, while using the upper 24 of the 32 reserved in- 
terrupts for communication with hardware devices and BIOS. Of these 24 vectors, the first eight were assigned to deal 
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with external device interrupts (INT 08h through OFh, for IRQO through 7 respectively). The remaining 16 provided, 
via software INT requests, standardized interfaces to the BIOS routines. 

When the next version of the processor, the 80186, appeared, problems ensued. Trade journals reported that the 
conflict between IBM’s use of the reserved locations, and Intel’s subsequent assignment of them, were the reason that 
no IBM machine used the 80186, but this was never publicly confirmed. However the following chip, the 80286, was 
more restrained in its assignment of interrupt actions. Subsequent designs have followed its lead; all of the first 32 lo- 
cations now have internal actions assigned for at least some versions of the processor family, but all remain compati- 
ble with MS-DOS usage. 

So far as the processor’s actions are concerned, there is almost no difference between an interrupt caused by one of 
the sources and another caused by any other. The only significant difference is that external interrupts automatically 
disable response to additional external interrupt requests, while software interrupts do not, 


Some Words of Caution 

Much of the information in this book is undocumented, and has therefore been determined by tracing calls and by 
trial-and-error experiments. Such undocumented information may be inaccurate, incomplete, highly version-depen- 
dent, or have any mix of these attributes. You should take care when attempting to use any calls marked as "internal" 
or "undocumented", or containing a large amount of italicized text (signifying its questionable or incomplete nature), 
Further, you should use documented equivalents whenever possible, even if the undocumented call is simpler or 
faster. 

Version information has been included in many function descriptions; note, however, that this information repre- 
sents only the version limits that we (or our contributors) were able to verify. Especially in the case of third-party soft- 
ware, any function may well have been present but undetected in versions earlier than those listed. And open-ended 
items such as "Version 2.1+" (meaning “all versions equal to or newer than 2.1") may have a hidden upper limit im- 
posed by changes not reported to us before this information went to press. 


Sample Entry 
To illustrate some of the aspects of the entries in this book which may not be self-explanatory, we present a mythical 
function followed by explanations of various parts of the entry. 


INTERRUPT FFh - Function 0Fh 
GET GONKULATOR SETTINGS 


Purpose: Determine the current or default options for the gonkulator. 


Available on: XYZZY models 17 and 23 only. Restrictions; FROB.SYS must be installed. 

Registers at call: Return Registers: 

AH = 0Fh CF clear if successful 

AL = subfunction CX = number of times settings have been modified 
Olh get default settings since startup 
02h get current settings ES:DI buffer filled 

ES:DI - > settings table (Table 99-1) CF set on error 


AX = error code (02h,FFh) (see Function 00h) 
Details: The link farm directory is the location for the write-only memory, among other things, 
Conflicts: DIDDLE.SYS (chapter 42) 
See Also: Function 0Eh, DIDDLE.SYS INT FEh Function 02h (chapter 42) 


Table 99-1. Format of Settings Table: 


Offset Size Description 
00h WORD heartbeat frequency in Hertz 
02h BYTE feeper duration 


03h BYTE feeper pitch 
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Table 99-1, Format of Settings Table (continued) 


Offset Size Description 

04h DWORD __ microfortnights between pings 
08h 64 BYTEs link farm directory name 
Explanations 


Following the heading which indicates the interrupt number, function number, and subfunction number (if applicable) 
along with the function name, each entry has a number of fields. Available on usually specifies the system or hard- 
ware which provides the call, but occasionally indicates the operating system or environment instead. Both Registers 
at call and Return Registers may have multiple mutually-exclusive cases, which are indicated by indentation, Thus, 
for this example, the call modifies CX and the user’s buffer if the carry flag is clear on return, but modifies AX in- 
stead if the carry flag is set. 

The cross-references for Conflicts and See Also indicate which chapter contains the referenced call, unless it is in 
the current chapter. Thus, the example has two references to chapter 42, and one to the current chapter. Conflicts 
specifies calls that use the same interrupt and function; you would look in chapter 99 for interrupt FFh Function OFh 
(or, in some cases, simply interrupt FFh) in the section for DIDDLE.SYS if the chapter is divided into sections, For 
See Also, the interrupt number is omitted if it is the same as the interrupt for the current entry; thus, you would look 
up interrupt FFh, function OEh in the current chapter. 

In all sections, information which is known to be incomplete or of questionable accuracy is italicized. This gener- 
ally occurs only for undocumented calls. 
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Reference Section Organization 


This brief listing shows which chapters describe functions for each of the 256 possible interrupts. Those referenced as 
"Chapter 1" are not discussed in detail and are shown only to make the list complete. Those referenced for more than 
one chapter probably have conflicts under some conditions. 

Two areas in particular have a high probability of conflicts. The first is the multiplex interrupt, 2Fh, and the sec- 
ond is the user interrupts, 60h to 66h, 

Interrupt 2Fh is shared by many programs, with the value of AH on call specifying the program which is to handle 
the call. As more programs use the multiplex interrupt to provide an interface to resident code, the probability of con- 
flicting multiplex numbers (the value in AH) increases. While there is a standardized method for determining whether 
a particular multiplex number is in use, there is no standardized approach to determine whether a specific program is 
using it, Thus, a program may be fooled into thinking that it is already installed if a different program happens to be 
using the same multiplex number. Table 1-2 lists programs we have identified as using the multiplex interrupt, but it 
is almost certainly incomplete despite our best efforts. 

We recommend the following steps for automatically avoiding conflicts of multiplex numbers on Interrupt 2Fh: 

1. choose a range of multiplex numbers to search 

2. implement a two-level installation check as described below 

3. search the chosen range for multiplex numbers which are not in use, and a multiplex number which answers 
as installed to the second level of the installation check. 

The first level of the two-level installation check consists of the standard AL=00h call/AL=FFh response. How- 
ever, if additional registers have specific flag values on call, additional registers will be modified on return. Thus, 
product WXYZ may have the following installation check: 


Call: == AH = multiplex number Return: 
AL = 00h AL = FFh 
Call: AH = multiplex number Return: 
AL = 00h AL = FFh 
BX = 5758h WX’) BX = 4F4Bh (’OK’) 
CX = 595Ah YZ’) ES:DI - entry point 


The first form of the call allows other programs to detect that the multiplex number is already in use, while not de- 
stroying registers in a nonstandard way. The second form allows a program to determine who is using the multiplex 
number. For an example of such a two-level installation check, see Interrupt 2Fh, Function DEh in chapter 15, Due to 
the number of programs now chaining Interrupt 2Fh, it is advisable to provide an entry point that may be called di- 
rectly, bypassing the interupt chain. 

The multiplex installation checks for a number of existing programs modify registers other than AL—even with- 
out the presence of flag values on entry. Thus, any program which searches a range of multiplex numbers must be 
prepared for all registers except $S:SP in order to be destroyed by an attempted installation check. 

The user interrupts 60h to 66h do not have a standard installation-check call, and thus require a different approach. 
However, the user interrupts are rarely chained, so a check whether the vector is 0000h:0000h suffices to determine if 
a particular interrupt is available. To determine whether the vector is in use by the program making the installation 
check, the usual approach is to place a signature string immediately prior to (or occasionally after) the interrupt han- 
dler, Table 1-3 lists programs we have identified as using this group of interrupts, but, like Table 1-2, it is almost cer- 
tain to be incomplete and, even had it included all such programs when this volume went to press, it could not include 
any added subsequently. 
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1-2 Reference Section Organization 


A final area of conflict needs to be mentioned here, as it is the reason so few programs use interrupts 86h through 
FOh. These are used by the BASIC interpreter in the ROM of genuine IBM machines to allow extensions and 
tracing. The BASIC.COM and BASICA.COM extensions of the ROM Cassette BASIC set these vectors to handlers 
inside themselves at startup, but never restore them. Thus, any resident programs which have hooked any of these 
interrupts will lose them if the user runs an interpreted BASIC program. Worse, the vectors will be pointing at 
whatever code or data happened to be loaded into those locations since BASIC terminated, virtually guaranteeing a 
system crash. GWBASIC (the version for those without an IBM ROM containing BASIC) on the other hand, only 
uses interrupts EFh and FOh, and restores those vectors on exit. 


Table 1-1, Master Reference List 





INT Chap Description 
00 2 CPU-generated 
01 2 CPU-generated 
02 2: external hardware, HP 95LX 
03 2 CPU-generated, 
36 Soft-ICE 
04 2 CPU-generate 
05 2 CPU-generated, 
3 Print Screen 
06 2 CPU-generated, 
4 HP 95LX 
07 2 CPU-generated 
08 2 CPU-generated, IRQO 
09 2 CPU-generated, IRQ1 
0A 2 CPU-generated, LPT2 (PC), Roland MPU MIDI interface, Tandy 1000 Hard Disk, 
Vertical Retrace Interrupt 
0B 2 COM2, CPU-generated, HP 95LX 
0c 2 COM1, CPU-generated, 
26 IBM System 36/38 Workstation Emulation 
oD 2 CPU-generated, Fixed Disk (PC,XT), LPT2 (AT), Tandy 1000 60 Hz RAM Refresh, 
HP 95LX, reserved (PS/2) 
0E CPU-generated, Diskette Controller, HP 95LX 


2 
OF 2 Parallel Printer, HP 95LX 
10 2 CPU-generated, 

5 BIOS Window Extension v1.1, DESQview Video, Direct Graphics Interface Standard 
(DGIS), EGA Register Interface Library, Everex Extended Video BIOS, FRIEZE, 
UltraVision, VESA SuperVGA BIOS, VIDEO, VUIMAGE Display Driver, 


9 GO32 DOS extender, 

15 TopView, 

18 Alloy 386/MultiWare, 

28 Carbon Copy Plus, 

36 FASTBUFF.COM, SCROLOCK.COM 
set 2 CPU-generated, 

3 Get Equipment List, 

7 BNU FOSSIL, 

17 BACK&FORTH 
12 3 Get Memory Size, 


17 BACK&FORTH 
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Table 1-1, Master Reference List (Continued) 


INT 
13 


14 


15 


16 


17 


18 
19 
1A 


1B 
1c 
1D 
1E 
1F 
20 


21 


Chap 
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sr 
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w we 
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Description 

Disk, ESDI Fixed Disk, Floppy Disk, Future Domain SCSI Controller, 

Hard Disk, HyperDisk, IBMCACHE.SYS, PC-CACHE, Priam EDVR.SYS, 
QCACHE, SWBIOS, Super PC Kwik 

Video FOSSIL, 

3com BAPI Serial 1/0, COURIERS.COM, FOSSIL (Fido/Opus/Seadog 
Standard Interface Level), IBM/Yale EBIOS Serial 1/0, 

Interconnections Inc. TES, Serial I/O, 

MultiDOS Plus [ODRV 

Alloy 386/MultiWare 

Cassette, Joystick Support, OS Hooks, System functions, Wait functions, 
Amstrad PC1512, Compaq machines, EISA System ROM, Phoenix 386 BIOS, 
ESDI Formatting, 

PRINT.COM, 

DOS/16M, 

DESQview, TopView, 

MultiDOS Plus, 

Omniview Multitasker, VMiX 

Keyboard, 

Compaq machines, 

Paint Tools, 

PC-Cache, 

MS Windows, 

Shamrock Software EMAIL, 

peANY WHERE III, 

PC Tools BACKTALK, PC Tools DESKTOP, PC Tools PCShell, PC Tools PCRUN, 
FAKEY.COM, KBUF, MAKEY.COM, Microsoft Word, PC Magazine PUSHDIR.COM, 
TurboPower TSRs, WATCH.COM 

Printer, 

Allow NTNX and 386/MultiWare, 

NorthNet Jetstream, Shamrock Software NET.24, 

FLASHUP.COM, INSET, PC Magazine PCSpool, SPEEDSCR.COM 

Start Cassette BASIC 

Bootstrap Loader 

PCjr, Time, 

AT&T 6300, 

Disk Spool II, Word Perfect, 


Control-Break Handler 

System Timer Tick 

Video Parameter Tables 

Diskette Parameters 

8x8 graphics font 

DOS, 

Minix 

NewSpace, PC Tools PC-CACHE, PCMag PCMANAGE/DCOMPRESS, Stacker, 
SMARTDRV.SYS 

MS-DOS, Concurrent DOS, DOS + Microsoft Networks, DR DOS, STARLITE 
architecture, 
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Table 1-1. Master Reference List (Continued) 


INT 
21 (cont.) 


22 
23 
24 
25 


26 
27 
28 
29 
2A 


2B 
2C 


2D 
2E 
2F 
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Description 

03/286, OS/386, OS/386 VMM, Phar Lap 386/DOS-Extender, Phar Lap 386/DOS- 
Extender VMM, 

DESQview, 

CTask, DoubleDOS, 

Novell NetWare, 

LANtastic Network, 

Banyan VINES, 

Attachmate Extra, IBM System 36/38 Workstation Emulation, 

LAN Manager Enhanced, LANstep, Network Driver Interface Specification, Topware 
Network Operating System, 

pcANY WHERE IV, 

F-DRIVER.SYS, miscellaneous viruses 

CED (Command EDitor), DOSED, ELRES, HIGHUMM.SYS, LASTBYTE.SYS, TAME, 
WCED, WILDUNIX.COM 

DOS 

DOS 

DOS 

Stacker 

DOS 

DOS 

DOS 

DOS 2+ 

DOS 2+ 

LANtastic Network, 

IBM PC 3270 Emulation Program, 

AT&T Starlan Extended NetBIOS, Microsoft Networks, NETBIOS 

DOS 2+ 

DOS 2+, STARLITE architecture, 

MS Windows??? 

DOS 2+ 

Pass Command to Command Interpreter for Execution, 4D0S SHELL2E.COM 
SCRNSAV2.COM, 

AUTOPARK.COM, HyperDisk, 

AVATAR Serial Dispatcher, 

ANSLSYS, APPEND, ASSIGN, COMMAND.COM, DISPLAY.SYS, DOS 3+ Critical 
Error Handler, DOS 3+ internal, DOS 5.0 kernel, DOSKEY, DOSSHELL, DRIVER.SYS 
support, EGA.SYS, GRAPHICS.COM, GRAFTABL.COM, IFSFUNC.EXE, 
KEYB.COM, NLSFUNC.COM, OS/2 compatibility box, PRINT.COM, SHARE, 
SHELLB.COM, Task Switcher, XMA2EMS.SYS 

Borland DOS extender, Ergo DOS extenders, Generic DOS extender installation check, 
Phar Lap DOS extenders, 

XMS, 

Borland DPMI Loader, DOS Protected-Mode Interface, 

MS WINDOWS, MS WINDOWS "WINOLDAP", 

DESQview 2.26 External Device Interface, Quarterdeck MANIFEST, Quarterdeck 
QEMM/QRAM, Quarterdeck VIDRAM, 
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Table 1-1, Master Reference List (Continued) 


INT 
2F (cont.) 
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Description 

CDROM, MSCDEX (MS CD-ROM Extensions), Network Redirector, PC LAN Program 
REDIR.SYS, PC Network RECEIVER.COM, 

Novell NetWare, Novell ODI Link Support Layer (LSL.COM), 

LANtastic Network, 

Banyan VINES, 

IBM PC3270 Emulation Program, 

EASY-NET, LAN Manager Enhanced, Topware Network Operating System, 
LapLink Quick Connect, TeleReplica, 

Communicating Applications Specification, 

Intel Image Processing Interface, 

F-PROT, TBSCANX, ThunderByte, 

4DOS, ANARKEY, AVATAR.SYS, BMB Compuscience Canada Utilities Interface, 
GOLD,COM, InnerMission, MDEBUG, Norton Utilities, RAID, RESPLAY, 
SoftCom programs, SWELL.EXE, TRAP.COM, TesSeRact RAM-resident 
program interface, VIDCLOCK.COM, WHOA!.COM 

(NOT A VECTOR!) FAR JMP instruction for CP/M-style calls 
overwritten by CP/M jump instruction in 30, 

DOS Protected-Mode Interface 

reportedly used by "Tiny" Viruses 

Logitech Mouse, Microsoft Mouse, PCMOUSE Mouse 

Borland/Microsoft languages, Floating Point emulation 

Borland/Microsoft languages, Floating Point emulation 

Borland/Microsoft languages, Floating Point emulation 

Borland/Microsoft languages, Floating Point emulation 

Borland/Microsoft languages, Floating Point emulation 

Borland/Microsoft languages, Floating Point emulation 

Borland/Microsoft languages, Floating Point emulation 

Borland/Microsoft languages, Floating Point emulation 

Borland/Microsoft languages, Floating Point emulation 

Borland/Microsoft languages, Floating Point emulation 

Borland languages, Floating Point emulation "shortcut" call 

Microsoft Dynamic Link Library manager, Overlay manager interrupt 
Z100 Master 8259, 

ROM BIOS Diskette Handler Relocated by Hard Disk BIOS 

Z100 Master 8259, 

Hard Disk 0 Parameter Table 

Z100 Master 8259, 

Video (EGA, VGA) 

Z100 Master 8259, 

Video Character Table 

Z100 Master 8259, 

PCjr BIOS Character Font, 

Novell NetWare High-Level Language API, 

IBM 3270-PC High Level Language API 

Z100 Master 8259 
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Table 1-1, Master Reference List (Continued) 





INT Chap Description 
46 2 Z100 Master 8259, 
6 Hard Disk 1 Drive Parameter Table 
47 2 Z100 Master 8259, 
36 SQL Base 
48 2 Z100 Slave 8259, 
3 Keyboard (PCjr) 
49 2 Z100 Slave 8259, 
3 Scan-Code Translation (PCjr), 
4 Texas Instruments PC Video 
36 MAGic 
4A 2 Z100 Slave 8259, 
3 User Alarm Handler 
4B 2 Z100 Slave 8259, 
6 Common Access Method SCSI interface, IBM SCSI interface, 
12 Virtual DMA Specification (VDS) 
4c 2 Z100 Slave 8259 
4D 2 Z100 Slave 8259 
4E 2 Z100 Slave 8259, 
6 TI Professional PC - DISK I/O 
4F 2 Z100 Slave 8259, 
6 Common Access Method SCSI interface 
50 2 IRQO relocated by DESQview, IBM 3278 emulator, and OS/2 
27 TIL Xpert AIM (X.25) 
Sl 2 IRQ] relocated by DESQview, IBM 3278 emulator, and OS/2 
52 2 IRQ? relocated by DESQview, IBM 3278 emulator, and OS/2 
33 2 IRQ3 relocated by DESQview, IBM 3278 emulator, and OS/2 
54 2 IRQ4 relocated by DESQview, IBM 3278 emulator, and OS/2 
55 2 IRQS relocated by DESQview, IBM 3278 emulator, and OS/2 
56 2 IRQ6 relocated by DESQview, IBM 3278 emulator, and OS/2 
57 2 IRQ? relocated by DESQview, IBM 3278 emulator, and OS/2 
58 2 IRQO relocated by DoubleDOS, IRQ8 relocated by DESQview 2.26+ 
59 2 IRQ] relocated by DoubleDOS, IRQ9 relocated by DESQview 2.26+, 
5 GSS Computer Graphics Interface (GSS*CGI) 
SA 2 IRQ1O relocated by DESQview 2,26+, IRQ2 relocated by DoubleDOS, 
27 Cluster adapter BIOS entry address 
5B 2 IRQI1 relocated by DESQview 2.26+, IRQ3 relocated by DoubleDOS, 
18 Alloy NTNX, 
27 AT&T Starlan Extended NetBIOS, Microsoft Network Transport Layer Interface, cluster 
adapter 
5c 2 IRQ12 relocated by DESQview 2.26+, IRQ4 relocated by DoubleDOS 
27 $25 LAN, ATALK.SYS, IBM 802.2 Interface (LLC), NetBIOS Interface, TOPS Interface 
5D 2 IRQ13 relocated by DESQview 2.26+, IRQS relocated by DoubleDOS 
SE 2 IRQ14 relocated by DESQview 2.26+, IRQ6 relocated by DoubleDOS 
SF 2 IRQI5 relocated by DESQview 2,26+, IRQ7 relocated by DoubleDOS, 
4 HP 95LX 


Table 1-1. Master Reference List (Continued) 


INT 
60 


61 


62 


63 


64 


65 


66 


67 


68 


69 


6A 


Chap 


Description 

reserved for user interrupt, 
Atari Portfolio, HP 95LX, 
Adaptec and OMTI controllers, 
Banyan VINES, 3com, 
10-NET, 

Tangram Arbiter, 

FTP Packet Driver, 

Zero Bug Virus, 

JPI TopSPEED Modula-2 


INTRSPY/CMDSPY API, MDEBUG, PC-IPC API, PC/370, SYS_PROF.EXE 


reserved for user interrupt, 
Atari Portfolio, HP 95LX, 
Adaptec and OMTI controllers, 
Banyan VINES, 


Sangoma CCIP (CCPOP 3270 resident module) Interface, 


FTP Software PC/TCP 

JPI TopSPEED Modula-2 
reserved for user interrupt, 
Adaptec and OMTI controllers, 
Cswitch, 


MS SQL Server/Sybase DBLIBRARY interface 


reserved for user interrupt, 


4+Power Floppy Controller, Adaptec and OMTI controllers, 


Oracle SQL Protected Mode Executive 


reserved for user interrupt, Data General DG10, 


Adaptec controllers, 

Oracle SQL Protected Mode Executive, 
Novell NetWare, 

Extended Batch Language v3.14+ 


reserved for user interrupt, Data General DG10, 


Adaptec controllers, 


FTP Software NDIS-Packet Driver adapter, 


Ad Lib SOUND.COM, SD.COM v6.2 


reserved for user interrupt, Data General DG10, 


Adaptec controllers, 


The IBM Digitized Sound Package, MicroHelp Stay-Res/Stay-Res Plus 


Adaptec controllers, 


EEMS, LIM EMS, Virtual Control Program Interface, 
Alloy NTNX (see PC-Net in chapter 27) 
Sangoma CCPOP 3270 resident module, 


PC-Net 


A 


PPC/PC, 


Sangoma CCPOP 3270 resident module 


Zenith AT BIOS, 


D 


ECnet DOS CTERM 


DECnet DOS Local Area Transport, 





ie) 


PTHELP.COM 
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Table 1-1. Master Reference List (Continued) 


INT Chap Description 
6B 20 Novell NASI/NACS, 
27 Ungermann-Bass Net One SERIAL I/O, 
34 "Saddam" virus, 
36 Tandy SCHOOLMATE PLUS 
6C 3 system resume vector (Convertible), 
8 DOS 3.2 Realtime Clock update 
6D 5 ATI VGA Wonder, VGA, 
24 DECnet DOS 
6E 24 DECnet DOS 
6F 4 HP ES-12 Extended BIOS, 
20 Novell NetWare, 
23 10-NET 
70 2 IRQ8 - CMOS Real-Time Clock, 
34 “stupid” virus 
71 2 TRQ9 - Redirected to OA by BIOS 
72 2 IRQ1O - Reserved 
73 2 IRQ1I - Reserved 
74 2 IRQ12 - Pointing Device 
75 2 IRQ13 - Math Coprocessor Exception 
716 2 IRQ14 - Hard Disk Controller 
77 2 IRQ1S5 - Power Conservation (Compaq), 
2 IRQI5 - RESERVED (AT,PS) 
8 9 DBOS, 
36 TARGA.DEV 
79 36 AVATAR.SYS 
TA 20 Novell NetWare Low-Level API (IPX) Driver, 
26 IBM 3270 Workstation Program API, IBM Personal Communications/3270, 
27 Topware Network Operating System, 
36 AutoCAD Device Interface 
7B 26 Eicon Access API (3270/5250 gateways), 
36 Btrieve API 
TC 1 IBM REXX88PC command language 
7D 1 not used 
TE 1 DIP, Ltd. ROM Library 
TF 5 Halo88, HDILOAD.EXE, 
17 MultiLink Advanced, 
18 Alloy 386/MultiWare, NINX, and ANSK, 
26 HLLAPI (IBM 3270 High-Level Language API), 
27 Convergent Technologies ClusterShare CTOS Access Vector 
80 1 reserved for BASIC, 
27 QPC Software PETINT.COM, 
36 Q-PRO4, SoundBlaster SBFM 
8I 1 reserved for BASIC, 
27 IBM Token Ring Adapter 
82 1 reserved for BASIC, 


27 IBM Token Ring Adapter 
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Table 1-1. Master Reference List (Continued) 


INT 
83 
84 
85 
86 


87 


88 


89 
8A 


8B 


8C 


8D 
8E 
8F 
90 


91 


92 


93 


94, 
95 


96 
97 
98 
99 
9A 
9B 
9C 
9D 
9E 
9F 
AO 


Al 
A2 


Chap 
1 
1 





Description 

reserved for BASIC 

reserved for BASIC 

reserved for BASIC 

used by IBM ROM BASIC while in interpreter, 
NETBIOS - Original INT 18h, 

APL*PLUS/PC 

used by IBM ROM BASIC while in interpreter, 
APL*PLUS/PC 
used by IBM ROM BASIC while in interpreter, 
APL*PLUS/PC 
used by IBM ROM BASIC while in interpreter 
used by IBM ROM BASIC while in interpreter, 
APL*PLUS/PC 
used by IBM ROM BASIC while in interpreter, 
APL*PLUS/PC 
used by IBM ROM BASIC while in interpreter, 
APL*PLUS/PC 
used by IBM ROM BASIC while in interpreter 
used by IBM ROM BASIC while in interpreter 
used by IBM ROM BASIC while in interpreter 
used by IBM ROM BASIC while in interpreter, 
APL*PLUS/PC 
used by IBM ROM BASIC while in interpreter, 
IBM TOKEN RING ADAPTER 

used by IBM ROM BASIC while in interpreter, 
Sangoma X.25 Interface Program 

used by IBM ROM BASIC while in interpreter, 
IBM Token Ring Adapter 

used by IBM ROM BASIC while in interpreter 
used by IBM ROM BASIC while in interpreter, 
APL"PLUS/PC 

used by IBM ROM BASIC while in interpreter 
used by IBM ROM BASIC while in interpreter 
used by IBM ROM BASIC while in interpreter 
used by IBM ROM BASIC while in interpreter 
used by IBM ROM BASIC while in interpreter 
used by IBM ROM BASIC while in interpreter 
used by IBM ROM BASIC while in interpreter 
used by IBM ROM BASIC while in interpreter 
used by IBM ROM BASIC while in interpreter 
used by IBM ROM BASIC while in interpreter 
used by IBM ROM BASIC while in interpreter, 
APL*PLUS/PC 
used by IBM ROM BASIC while in interpreter 
used by IBM ROM BASIC while in interpreter 
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Table 1-1. Master Reference List (Continued} 


INT 
A3 
A4 


AS 
AG 
AT 
A8& 
AQ 
AA 
AB 
AC 
AD 
AE 
AF 
BO 
Bl 
B2 
B3 


B4 
BS 

B6 
B7 

B8 

B9 
BA 
BB 
BC 
BD 
BE 
BF 
co 
cl 

C2 
C3 
C4 
C5 
C6 


C7 


cs 


Chap 





Description 
used by IBM ROM BASIC while in interpreter 


used by IBM ROM BASIC while in interpreter, 
Right Hand Man API 


used by IBM ROM BASIC while in interpreter 
used by IBM ROM BASIC while in interpreter 
used by IBM ROM BASIC while in interpreter 
used by IBM ROM BASIC while in interpreter 
used by IBM ROM BASIC while in interpreter 
used by IBM ROM BASIC while in interpreter 
used by IBM ROM BASIC while in interpreter 
used by IBM ROM BASIC while in interpreter 
used by IBM ROM BASIC while in interpreter 
used by IBM ROM BASIC while in interpreter 
used by IBM ROM BASIC while in interpreter 
used by IBM ROM BASIC while in interpreter 
used by IBM ROM BASIC while in interpreter 
used by IBM ROM BASIC while in interpreter 


used by IBM ROM BASIC while in interpreter, 
ZIPKEY 


used by IBM ROM BASIC while in interpreter 
used by IBM ROM BASIC while in interpreter 
used by IBM ROM BASIC while in interpreter 
used by IBM ROM BASIC while in interpreter 
used by IBM ROM BASIC while in interpreter 
used by IBM ROM BASIC while in interpreter 
used by IBM ROM BASIC while in interpreter 
used by IBM ROM BASIC while in interpreter 
used by IBM ROM BASIC while in interpreter 
used by IBM ROM BASIC while in interpreter 
used by IBM ROM BASIC while in interpreter 
used by IBM ROM BASIC while in interpreter 
used by IBM ROM BASIC while in interpreter 
used by IBM ROM BASIC while in interpreter 
used by IBM ROM BASIC while in interpreter 
used by IBM ROM BASIC while in interpreter 
used by IBM ROM BASIC while in interpreter 
used by IBM ROM BASIC while in interpreter 
used by IBM ROM BASIC while in interpreter, 
APL*PLUS/PC 

used by IBM ROM BASIC while in interpreter, 
APL*PLUS/PC 

used by IBM ROM BASIC while in interpreter, 
APL*PLUS/PC 
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Table 1-1. Master Reference List (Continued) 

















INT Chap Description 

co used by IBM ROM BASIC while in interpreter, 
3t APL*PLUS/PC 

CA used by IBM ROM BASIC while in interpreter, 
31 APL*PLUS/PC 

CB used by IBM ROM BASIC while in interpreter, 
31 APL*PLUS/PC 

cc used by IBM ROM BASIC while in interpreter, 
31 APL*PLUS/PC 

cD used by IBM ROM BASIC while in interpreter, 
31 APL*PLUS/PC 

CE used by IBM ROM BASIC while in interpreter, 
31 APL*PLUS/PC 

CF used by IBM ROM BASIC while in interpreter, 
31 APL*PLUS/PC 

DO used by IBM ROM BASIC while in interpreter, 
31 APL*PLUS/PC 

DI used by IBM ROM BASIC while in interpreter, 
3h APL*PLUS/PC 

D2 used by IBM ROM BASIC while in interpreter, 
31 APL*PLUS/PC 

D3 used by IBM ROM BASIC while in interpreter, 
31 APL*PLUS/PC 

D4 1 used by IBM ROM BASIC while in interpreter, PC-MOS/386 API, 
31 APL*PLUS/PC 

DS 1 used by IBM ROM BASIC while in interpreter, 
31 APL*PLUS/PC 

D6 1 used by IBM ROM BASIC while in interpreter, 
31 APL*PLUS/PC 

D7 t used by IBM ROM BASIC while in interpreter, 
31 APL*PLUS/PC 

D8 I used by IBM ROM BASIC while in interpreter, 
31 APL*PLUS/PC 

D9 1 used by IBM ROM BASIC while in interpreter, 
31 APL*PLUS/PC 

DA 1 used by IBM ROM BASIC while in interpreter, 
31 APL*PLUS/PC 

DB 1 used by IBM ROM BASIC while in interpreter, 
31 APL*PLUS/PC 

DC 1 used by IBM ROM BASIC while in interpreter, 
31 APL*PLUS/PC, 
36 PC/370 

DD | used by IBM ROM BASIC while in interpreter, 
31 APL*PLUS/PC 

DE 1 used by IBM ROM BASIC while in interpreter, 


31 APL*PLUS/PC 
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Table 1-1. Master Reference List (Continued) 











INT Chap Description 
DF used by IBM ROM BASIC while in interpreter, 
4 Victor 9000, 
31 APL*PLUS/PC 
EO used by IBM ROM BASIC while in interpreter, 
31 APL*PLUS/PC, 
34 "Micro-128" virus, 
36 CP/M-86 function calls 
El used by IBM ROM BASIC while in interpreter, PC Cluster Disk Server Information 
E2 I used by IBM ROM BASIC while in interpreter, PC Cluster Program 
E3 used by IBM ROM BASIC while in interpreter 
E4 used by IBM ROM BASIC while in interpreter, 
35 Logitech Modula v2.0 
ES L used by IBM ROM BASIC while in interpreter 
E6 used by IBM ROM BASIC while in interpreter 
E7 used by IBM ROM BASIC while in interpreter 
Es used by IBM ROM BASIC while in interpreter 




















1 
E9 if used by IBM ROM BASIC while in interpreter 
EA 1 used by IBM ROM BASIC while in interpreter 
EB 1 used by IBM ROM BASIC while in interpreter 
EC 1 used by IBM ROM BASIC while in interpreter, 
18 Alloy NTNX, 
35 Exact Runtime Interface Multiplexor 
ED 1 used by IBM ROM BASIC while in interpreter 
EE 1 used by IBM ROM BASIC while in interpreter 
EF 35 compiled BASIC, interpreted BASIC, 
36 GEM 
FO 35 compiled BASIC, interpreted BASIC 
Fl 1 reserved for user interrupt, 
36 SPEECH.COM 
F2 1 reserved for user interrupt 
F3 1 reserved for user interrupt 
F4 reserved for user interrupt, 
17 DoubleDOS 
F5 reserved for user interrupt, 
7 DoubleDOS 
F6 reserved for user interrupt, 
7 DoubleDOS 
FT 1 reserved for user interrupt, 
7 DoubleDOS 
F8 reserved for user interrupt, 
Ki DoubleDOS 
F9 reserved for user interrupt, 
A DoubleDOS 
FA reserved for user interrupt, 
7 DoubleDOS 
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Table 1-1, Master Reference List (Continued) 








INT Chap Description 
FB 1 reserved for user interrupt, 

17 DoubleDOS 
FC 1 reserved for user interrupt, 

17 DoubleDOS 
FD 1 reserved for user interrupt, 

17 DoubleDOS 
FE 1 destroyed by return to real mode on AT/XT286/PS50+, 

17 DoubleDOS 
FF 1 destroyed by return to real mode on AT/XT286/PS50+, 

4 Z100 WARM BOOT 
Table 1-2. Multiplex Interrupt Usage 

Program Low Default 

PRINT.COM 00h,O1h 
PC LAN Program REDIR/REDIRIFS ‘ 02h 
DOS 3+ critical error messages F 05h 
DOS 3+ ASSIGN é 06h 
DOS 3+ DRIVER.SYS support Fi 08 
SHARE ‘ 10h 
Network redirector Ilh 
MSCDEX . ilh 
DOS 3+ internal utility functions : 12h 
DOS 3.3+ disk interrupt handler ‘ 13h 
NLSFUNC 3 14h 
CDROM support : 15h 
DOS 4,00 GRAPHICS.COM 15h 
MS Windows 5 16h 
MS Windows WINOLDAP : 17h 
DOS 4.0x SHELLB.COM ; 19h 
DOS 4+ ANSISYS i 1Ah 
AVATAR.SYS 1Ah 
DOS 4+ XMA2EMS.SYS 1Bh 
OS/2 compatibility box , 40h 
LAN Manager 2.0 DOS Enhanced NETPOPUP ; 41h 
LAN Manager 2.0 DOS Enhanced MSRV 2 42h 
XMS : 43h 
F-PROT utilities 46h 
MS Windows 3.0 46h 
DOS 5 HMA support 4Ah 
LAN Manager 2.0 DOS Enhanced NETWKSTA is 4Bh 
DOS 5 task switchers : 4Bh 
TesSeRact 54h 
DOS 5 COMMAND.COM interface : 55h 
SCRNSAV2.COM : 64h 
Novell NetWare IPX TAh 
PC/370 7Fh 
Easy-Net 80h 
RESPLAY 82h 
Whoa!.COM 89h 
RAID 90h 
InnerMission 93h 
Ergo DOS extenders Alh 
VIDCLOCK.COM AAh 


DOS 4.01+ GRAPHICS.COM ‘ ACh 


High 


Selection 
Fixes 
Fixe 
Fixed 
Fixes 
Fixed 
Fixed 
Fixed 
Fixed 
Fixed 
Fixed 
Fixed 
Fixed 
Fixed 
Fixed 
Fixed 
Fixed 
Fixed 
Fixed 
Fixed 
Fixed 
Fixed 
Fixed 
Fixed 
Fixed 
Fixed 
Fixed 
Fixed 
Fixe 

Fixed 
Fixed 
Fixed 
Fixed 
Fixed 
Fixed 
Fixed 
Fixe: 

Fixe 

Fixed 
Fixed 
Fixed 
Fixe 
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Table 1-2. Multiplex Interrupt Usage (Continued) 


Program Low Default High Selection 
DISPLAY.SYS : ADh ; Fixed 
KEYB.COM : ADh : Fixed 
DOS 3.3+ COMMAND.COM installable cmd 0 AEh é Fixed 
GRAFTABL a BOh ; Fixed 
IBM PC3270 emulation program Z B4h P Fixed 
APPEND 4 B7h p Fixed 
network 7 B&h : Fixed 
PC Network RECEIVER,.COM : Boh i Fixed 
MS Windows 3.0 EGA.SYS 00h BCh FFh Cmdline 
PC LAN Program REDIRIFS ; BFh : Fixed 
Novell ODI Link Support Layer COh COh FFh Automatic 
ThunderByte??? , C9h F Fixed 
TBSCANX . CAh : Fixed 
Communicating Applications Spec 00h CBh FFh Config 
Intel Image Processing Interface : CDh é Fixed 
SWELL c CDh Fi Fixed 
MDEBUG display driver COh DOh FEh Config, API 
MDEBUG command driver Clh Dih FFh Config, API 
Quarterdeck QEMM, QRAM, MFT COh D2h FFh Automatic 
TeleReplica ‘ D3h , Fixed 
LapLink Quick Connect ‘i D3h , Fixed 
4DO0S A D4h é Fixed 
Banyan VINES a D7h : Fixed 
TRAP.COM ‘ DAh ‘ Fixed 
GOLD.COM e DCh . Fixed 
SoftCom programs ° DDh : Fixed 
DESQview External Device Interface COh DEh FFh Automatic 
HyperDisk v4.2+ ‘ DFh Fixed 
Anarkey COh E3h FFh Cmdline 
Phar Lap DOS extenders : EDh : Fixed 
Generic DOS extender install check ‘ Fih . Fixed 
AUTOPARK.COM - F7h : Fixed 
Borland International ‘4 FBh i Fixed 
Norton Utilities . FEh : Fixed 
Topware Network Operating System ‘ FFh 4 Fixed 


BMB Compuscience Canada utilities 00h FFh FFh Automatic 


Table 1-3. User Interrupt Usage 
Program 

"Zero Bug" virus - 

Atari Portfolio user interface 

SYS_PROF 

PC-IPC API 

Tangram Arbiter API 

INTRSPY 

PC/370 

FTP Packet Driver 

MDEBUG 

10-Net 

3com 

HP 95LX System Manager 

JPI TopSPEED Modula-2 

Atari Portfolio extended BIOS 

FTP Software TCP/IP 

Sangoma CCIP 

Banyan VINES 

MS SQL server 

Cswitch 

4+Power floppy controller 

Oracle SQL prot. mode executive 

Extended Batch Language 

FTP Software NDIS-Packet Driver 

SD.COM shareware version 

Ad Lib SOUND,.COM 


DG10 MicroECLIPSE coproc i'face 


MicroHelp Stay-Res Plus 
IBM Digitized Sound Package 


Key: D = default interrupt 
a= alternate interrupt 
. = not usable by program 
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60h 61h 62h 63h 64h 6Sh 66h 


aehelwicloluivlolwvivloleie) 
eS 
= 
aS 


22 


pee 


ss 


Fixed 
Fixed 
Fixed 
Cmdline 
Config 
Automatic 
Patch 
Automatic 
Config 
Fixed 
Fixed 
Fixed 
Fixed 
Fixed 
Fixed 
Fixed 
Config 
Fixed 
Fixed 
Fixed 
Fixed 
Fixed 
Fixed 
Fixed 
Fixed 
Fixed 
Fixed 
Fixed 
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Chapter ? 


Hardware Interrupts 


This chapter describes hardware interrupts, including those generated internally by the CPU chip and those which ar- 
rive from external devices. Any interrupt signal described in this chapter may occur at any time. 


INTERRUPT 00h 
CPU-generated - DIVIDE ERROR 


Purpose: Generated if the divisor of a DIV or IDIV instruction is zero or the quotient overflows the result register; 
DX and AX will be unchanged, 

Available on: All machines. Restrictions: none 

Registers at call: n/a Return Registers: n/a 

Details: On an 8086/8088, the return address points to the instruction following the division instruction which caused 
the interrupt; on an 80286 or higher, the return address points to the beginning of the divide instruction (including any 
prefixes), 

Conflicts: None known. 

See Also: INT 04h 


INTERRUPT 01h 
CPU-generated - SINGLE STEP 


Purpose: Used by debuggers for single-instruction execution tracing, such as MSDOS DEBUG’s T command. 
Available on: All machines. Restrictions: none 

Registers at call: n/a Return Registers: n/a 

Details: This interrupt is generated after each instruction if TF (trap flag) is set; TF is cleared on invoking the single- 
step interrupt handler. Interrupts are prioritized such that external interrupts are invoked after the INT Olh pushes 
CS:IP/FLAGS and clears TF, but before the first instruction of the handler executes. 

Conflicts: None known, 

See Also: INT 03h 


INTERRUPT 01h 
CPU-generated - DEBUGGING EXCEPTIONS 


Purpose: Used by debuggers to halt program execution on any of a variety of conditions which may be detected by 
the CPU, 


Available on: 80386 and above, when hardware Restrictions: none, 
debug registers are enabled. 
Registers at call: n/a Return Registers: n/a 


Details: There are several different debugging traps: 
Instruction address breakpoint fault - will return to execute instruction 
Data address breakpoint trap - will return to the following instruction 
General detect fault, debug registers in use 
Task-switch breakpoint trap 

Conflicts: None known. 

See Also: INT 03h 
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INTERRUPT 02h 
external hardware - NON-MASKABLE INTERRUPT 


Purpose: Generated by the CPU when the input to the NMI pin is asserted. 
Available on: All machines. Restrictions: none. 
Registers at call: n/a Return Registers: n/a 
Details: The return address for this interrupt points to the start of the interrupted instruction on the 80286 and higher. 
Although the Intel documentation states that this interrupt is typically used for power-failure procedures, it has many 
other uses on IBM-compatible machines: 
Memory parity error: all except Jr, CONV, and some machines without memory parity 
Breakout switch on hardware debuggers 
Coprocessor interrupt: all except PCjr and Convertible 
Keyboard interrupt: PCjr, Convertible 
J/O channel check: Convertible, PS models 50 and higher 
Disk-controller power-on request: Convertible 
System suspend: Convertible 
Real-time clock: Convertible 
System watch-dog timer, time-out interrupt: PS/2 models 50 and higher 
DMA timer time-out interrupt: PS/2 models 50 and higher 
Low battery: Hewlett-Packard HP 9SLX 
Module pulled: HP 95LX 
Conflicts: None known, 


INTERRUPT 03h 
CPU-generated - BREAKPOINT 


Purpose: Generated by the one-byte breakpoint instruction (opcode CCh). 

Available on: All machines. Restrictions: none, 

Registers at call: n/a Return Registers: n/a 

Details: Used by debuggers to implement breakpoints, such as MSDOS DEBUG's G command. The one-byte 
breakpoint instruction is also used by Turbo Pascal versions | through 3 when the $U+ compiler directive is 
specified, The return address points to the byte following the breakpoint instruction. 

Conflicts: Soft-ICE Back Door commands (chapter 36). 

See Also: INT 01h 


INTERRUPT 04h 
CPU-generated - INTO DETECTED OVERFLOW 


Purpose: The INTO instruction will generate this interrupt if OF (Overflow Flag) is set; otherwise, INTO is 


effectively a NOP. 
Available on: All machines. Restrictions: none. 
Registers at call: n/a Return Registers: n/a 


Details: May be used for convenient overflow testing (to prevent errors from propagating) instead of JO or a 
JNO/JMP combination. 
See Also: INT 00h 


INTERRUPT 05h 
CPU-generated - BOUND RANGE EXCEEDED 


Purpose: Generated by BOUND instruction when the value to be tested is less than the indicated lower bound or 
greater than the indicated upper bound. 

Available on: 80186 and above. Restrictions: none. 

Registers at call: n/a Return Registers: n/a 

Details: Returning from this interrupt re-executes the failing BOUND instruction. 

Conflicts: IBM PC BIOS Print Screen interrupt (Chapter 3). 
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INTERRUPT 06h 

CPU-generated - INVALID OPCODE 

Purpose: Generated when the CPU attempts to execute an invalid opcode (most protected-mode instructions are 
considered invalid in real mode). Generated on BOUND, LDS, LES, or LIDT instructions which specify a register 
rather than a memory address. 

Available on: 80286 and above. Restrictions: none. 

Registers at call; n/a Return Registers: n/a 

Details: Return address points to beginning of invalid instruction. With proper programming, this interrupt may be 
used to emulate instructions which do not exist; many 386 BIOSes emulate the 80286 undocumented LOADALL 
instruction which was removed from the 80386 and higher processors. 

Conflicts: HP 95LX (chapter 4). 

See Also: CPU-generated INT 0Ch, CPU-generated INT ODh 


INTERRUPT 07h 

CPU-generated - PROCESSOR EXTENSION NOT AVAILABLE 

Purpose: Automatically called if a coprocessor instruction is encountered when no coprocessor is installed. Can be 
used to emulate a numeric coprocessor in software. 

Available on: 80286 and above. Restrictions: none. 

Registers at call: n/a Return Registers: n/a 

Conflicts: None known. 

See Also: CPU-generated INT 09h 


INTERRUPT 08h 
CPU-generated - DOUBLE EXCEPTION DETECTED 


Purpose: Called when multiple exceptions occur on one instruction, or an exception occurs in an exception handler. 
Called in protected mode if an interrupt above the defined limit of the interrupt vector table occurs. 

Available on: 80286 and above. Restrictions: none. 

Registers at call: n/a Return Registers: n/a 

Details: Return address points at beginning of instruction with errors or the beginning of the instruction which was 
about to execute when the external interrupt caused the exception. If an exception occurs in the double fault handler, 
the CPU goes into SHUTDOWN mode (which circuitry in the PC/AT converts to a reset); this “triple fault" is a 
faster way of returning to real mode on many 80286 machines than the standard keyboard controller reset. 

Conflicts: BIOS System Timer, IRQO. 


INTERRUPT 08h 
IRQO~ SYSTEM TIMER 


Purpose: Generated 18.2 times per second by channel 0 of the 8254 system timer, this interrupt is used to keep the 
time-of-day clock updated. 

Available on: All machines. Restrictions: Bit 0 of I/O port 21h must be clear. 
Registers at call: n/a Return Registers: n/a 

Details: Programs which need to be invoked regularly should use INT 1Ch unless they need to reprogram the timer 
while still keeping the time-of-day clock running at the proper rate. The default handler is at FOOOh:FEASh in IBM 
PC and 100%-compatible BIOSes. 

Conflicts: DOUBLE EXCEPTION DETECTED. 

See Also: INT 1Ch (chapter 3), User Alarm INT 4Ah (chapter 3), DESQview INT 50h, DoubleDOS INT 58h, INT 
70h 


INTERRUPT 09h 
CPU-generated - PROCESSOR EXTENSION PROTECTION ERROR 


Purpose: Called if the coprocessor attempts to access memory outside a segment boundary; it may occur at an 
arbitrary time after the coprocessor instruction was issued. 
Available on: 80286 and 80386 in protected mode. Restrictions: none. 


{ 
{ 
H 
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Registers at call: n/a Return Registers: n/a 

Details: Until the condition is cleared or the coprocessor is reset, the only coprocessor instruction which may be used 
is FNINIT; WAIT or other coprocessor instructions wil] cause a deadlock because the coprocessor is still busy 
waiting for data. 

Conflicts: BIOS Keyboard service routine (IRQI). 

See Also: CPU-generated INT 07h 


INTERRUPT 09h 
RESERVED BY Intel (80486 protected mode} 


Purpose: Not used, to avoid conflicts, 

Available on: 80486 operating in protected mode. Restrictions: none. 

Registers at call: n/a Return Registers: n/a 

Details: This exception has been moved to INT ODh on the 80486 because the math coprocessor is integrated into 
the CPU. 

Conflicts: None known. 

See Also: CPU-generated INT 09h, CPU-generated INT 0Dh 


INTERRUPT 09h 
1RQ1 - KEYBOARD DATA READY 


Purpose: Generated when data is received from the keyboard. 
Available on: All machines. Restrictions: Bit 1 of I/O port 2ih must be clear, 
Registers at call: n/a Return Registers: n/a 
Details: The received data is normally a scan code, but may also be an ACK or NAK of a command on AT-class 
keyboards. If the BIOS supports an enhanced (101/102-key) keyboard, it calls INT 15h Function 4Fh after reading 
the scan code from the keyboard and before further processing. 
The interrupt handler performs the following actions for certain special keystrokes: 

Ctrl-Break invoke INT 1Bh, set flag at 0040h:007 Lh 

SysRq invoke INT 15h Function 85h 

Ctrl-Numlock place system in a tight wait loop 

Ctrl-Alt-Del jump to BIOS startup code (either FOOOh:FFFOh or the destination of 

the jump at that address) 

Shift-PrtSc invoke INT 05h 
Conflicts: PROCESSOR EXTENSION PROTECTION ERROR fault on 80286 and 80386. 
See Also: DESQview INT 51h, DoubleDOS INT 59h, Print Screen INT 05h (chapter 3), INT 15h Functions 4Fh and 
85h (chapter 3), INT 16h (chapter 3), INT 1Bh (chapter 3) 


INTERRUPT 0Ah 
CPU-generated - INVALID TASK STATE SEGMENT 


Purpose: Indicates task switching error. 
Available on: 80286 and above. Restrictions: Available only in protected mode. 
Registers at call: n/a Return Registers: n/a 
Details: Automatically called during a task switch if the new TSS specified by the task gate is invalid for any of the 
following reasons: 

TSS limit is less than 43 (80286) 

LDT selector invalid or segment not present 

null SS selector, or SS selector outside LDT/GDT limit 

stack segment is read-only 

stack segment DPL differs from new CPL, or RPL <> CPL 

CS selector is outside LDT/GDT limit or not code 

non-conforming code segment's DPL differs from CPL 

conforming code segment’s DPL > CPL 

DS/ES selectors outside LDT/GDT limit or not readable segments 


| 
| 
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The handler must use a task gate in order to have a valid TSS under which to execute; it must also reset the busy 
bit in the new TSS. 
Conflicts: Roland MPU MIDI interface, Tandy hard disk, IRQ2. 
See Also: CPU-generated INT 0Bh 


INTERRUPT 0Ah 
1RQ2- VERTICAL RETRACE INTERRUPT 


Purpose: Indicates occurrence of vertical retrace time. 

Available on: EGA or VGA equipped systems. Restrictions: none, 

Registers at call: n/a Return Registers: n/a 

Details: The TOPS and PCnet adapters use this interrupt request line by default, DOS 3.2 revectors IRQ2 to a stack- 
switching routine, On ATs and above, the physical data line for IRQ2 is labeled IRQ9 and connects to the slave 
8259. The BIOS redirects the interrupt for IRQ9 back here. Under DESQview, only the INT 15h vector and BASIC 
segment address (the word at 0000h:05 10h) may be assumed to be valid for the handler's process. 

Conflicts: CPU-generated INVALID TASK STATE SEGMENT, Roland MPU MIDI interface, Tandy hard disk, 
LPT2, 

See Also: DESQview INT 52h, DoubleDOS INT SAh, INT 71h 


INTERRUPT 0Ah 

IRQ2- LPT2 

Purpose: Indicates that printer LPT2 needs attention. 

Available on: Original PC only. Restrictions: Will be preempted if EGA or VGA 
video card is in system. 

Registers at call: n/a Return Registers: n/a 


Details: Refer to IRQ2 for EGA/VGA. 
Conflicts; CPU-generated INVALID TASK STATE SEGMENT, Roland MPU MIDI interface, Tandy hard disk. 
See Also: DESQview INT 52h, DoubleDOS INT 5Ah, INT 71h 


INTERRUPT OAh 
IRQ2 - Tandy HARD DISK 


Purpose: Indicates hard disk requires action. 

Available on: Tandy 1000-series machines only. Restrictions: none. 

Registers at call: n/a Return Registers: n/a 

Details: May be masked by setting bit 2 on I/O port 21h 

Conflicts; CPU-generated INVALID TASK STATE SEGMENT, Roland MPU MIDI interface, LPT2. 
See Also: DESQview INT 52h, DoubleDOS INT 5Ah, INT 71h 


INTERRUPT 0Ah 
IRQ2~- ROLAND MPU MIDI INTERFACE 


Purpose: Attention request from MIDI peripherals. 

Available on: Ali machines. Restrictions: Roland MIDI interface must be installed. 
Registers at call: n/a Return Registers: n/a 

Details: Newer Roland cards and MIDI interfaces by other manufacturers use a jumper-selectable IRQ, but software 
and hardware generally defaults to IRQ2. 

Conflicts: CPU-generated INVALID TASK STATE SEGMENT, Tandy hard disk, LPT2, 

See Also: DESQview INT 52h, DoubleDOS INT SAh, INT 71h 


INTERRUPT 0Bh 
CPU-generated - SEGMENT NOT PRESENT 


Purpose: Generated when loading a segment register if the segment descriptor indicates that the segment is not 
currently in memory, unless the segment is an LDT (see INT OAh) or stack segment (see INT OCh) needed by a task 
switch, 

Available on: 80286 and above. Restrictions: Available only in protected mode. 
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Registers at call: n/a Return Registers: n/a 

Details: May be used to implement virtual memory by loading in segments as they are accessed, clearing the "not 
present” bit after loading. 

Conflicts: IRQ3. 

See Also: CPU-generated INT OAh, CPU-generated INT 0Eh 


INTERRUPT OBh 
IRQS - SERIAL COMMUNICATIONS (COM2) 


Purpose: Indicates service required by serial port COM2. 

Available on: Ali machines. Restrictions: Bit 3 of I/O port 21h must be clear. 
Registers at call: n/a Return Registers: n/a 

Details: the TOPS and PCnet adapters use this interrupt request line as an alternate. On PS/2's, COM2 through 
COMB share this interrupt; on many PC's, COM4 shares this interrupt. 

Conflicts: CPU-generated SEGMENT NOT PRESENT, HP 95LX keyboard. 

See Also: IRQ4 on INT 0Ch, DESQview INT 53h, DoubleDOS INT 5Bh 


INTERRUPT OBh 
LOW-LEVEL KEYBOARD HANDLER 


Purpose: Called when a key is pressed. The handler debounces the key, places its scan code in I/O register 60h, and 
invokes INT 09h. 

Available on: HP 95LX only. Restrictions: none. 

Registers at call: n/a Return Registers: n/a 

Conflicts: CPU-generated SEGMENT NOT PRESENT, COM2. 

See Also: Keyboard INT 09h 


INTERRUPT 0Ch 
CPU-generated - STACK FAULT 


Purpose: Generated on stack overflow/underflow in protected mode. Generated in protected mode if an inter-level 
transition or task switch references a stack segment marked "not present". Generated on accessing a word operand at 
SS:FFFFh in real mode. 

Available on: 80286 and above. Restrictions: none. 

Registers at call: n/a Return Registers: n/a 

Details: The 80286 will shut down in real mode if SP=0001h before a push, On the PC AT and compatibles, 
external circuitry generates a reset on shutdown. 

Conflicts: IRQ4, IBM System 36/38 workstation emulation (chapter 26). 

See Also: CPU-generated INT OBh 


INTERRUPT 0Ch 
IRQ4 - SERIAL COMMUNICATIONS (COM?) 


Purpose: Indicates serial port COM1 requires action. 

Available on: All machines. Restrictions: Bit 4 of I/O port 21h must be clear. 
Registers at call: n/a Return Registers: n/a 

Details: On many PC's, COM3 shares this interrupt. 

Conflicts: STACK FAULT, IBM System 36/38 workstation emulation (chapter 26). 

See Also: IRQ3 on INT OBh, DESQview INT 54h, DoubleDOS INT 5Ch 


INTERRUPT O0Dh 
CPU-generated - GENERAL PROTECTION VIOLATION 


Purpose: Traps any general protection fault; used for memory management. 
Available on: 80286 and above. Restrictions: none. 
Registers at call: n/a Return Registers: n/a 
Details: Called in real mode when: 

(1) an instruction accesses a word operand located at offset FFFFh; 
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(2) a PUSH MEM or POP MEM instruction contains an invalid bit encoding in the second byte; 
(3) an instruction exceeds the maximum length allowed (10 bytes for 80286, 15 bytes for 80386 and 
80486); 
(4) an instruction wraps from offset FFFFh to offset 0000h. 
Called in protected mode on protection violations not covered by INT 06 through INT OC, including: 
(1) segment limit violations; 
(2) write to read-only segments; 
(3) accesses using null DS or ES selectors; 
(4) accesses to segments with privilege greater than CPL; 
(5) wrong descriptor type. 
Called on 80486 protected-mode floating-point protection fault. 
Conflicts: IRQ5, Tandy 1000 RAM refresh, HP 95LX infrared interrupt. 
See Also: CPU-generated INT 09h, CPU-generated INT 0Ch 


INTERRUPT 0Dh 
IRQS - FIXED DISK (PC,XT), LPT2 (AT), reserved (PS/2) 


Purpose: Indicates completion of fixed-disk activity, or need for attention at LPT2 printer. 

Available on: All machines, Restrictions: none. 

Registers at call: n/a Return Registers: n/a 

Details: Under DESQview, only the INT 15h vector and BASIC segment address (the word at 0000h:0510h) may be 
assumed to be valid for the handler's process. May be masked by setting bit 5 on I/O port 21h. 

Conflicts: General Protection Violation, Tandy 1000 RAM refresh, HP 95LX infrared interrupt. 

See Also: IRQ6 on INT OEh, IRQ7 on INT OFh, DESQview INT 55h, DoubleDOS INT 5Dh 


INTERRUPT 0Dh 
IRQS - Tandy 1000 60 Hz RAM REFRESH 


Purpose: Signals time to refresh dynamic RAM. 

Available on: Tandy 1000 only. Restrictions: none. 
Registers at call: n/a Return Registers: n/a 
Conflicts: General Protection Violation, IRQ5, HP 95LX infrared interrupt. 

See Also: DESQview INT 55h 


INTERRUPT 0Dh 

INFRARED INTERRUPT 

Purpose: Indicates that the infrared data link needs attention. 

Available on: HP 95LX only. Restrictions: none. 
Registers at call: n/a Return Registers: n/a 


Conflicts: General Protection Violation, IRQ5, Tandy 1000 RAM refresh. 
See Also: DESQview INT 55h 


INTERRUPT 0Eh 
CPU-generated - PAGE FAULT 


Purpose: Signals attempt to address memory location not currently in selector tables, 
Available on: 80386 and above. 
Restrictions: CPU must be operating in native mode 
or V86 mode. 
Registers at call: n/a Return Registers: n/a 
Details: Used to implement virtual memory. 
Conflicts: IRQ6, HP 95LX external card interrupt, 
See Also: CPU-generated INT OBh 
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INTERRUPT 0Eh 
4IRQ6 - DISKETTE CONTROLLER 


Purpose: Generated by floppy disk controller on completion of an operation. 

Available on: All machines. Restrictions: Bit 6 of I/O port 21h must be clear. 
Registers at call: n/a Return Registers: n/a 

Details: The default handler is at FOO0h:EF57h in IBM PC and 100%-compatible BIOSes. 

Conflicts: Page Fault, HP 95LX external card interrupt. 

See Also: IRQS on INT 0Dh, DESQview INT 56h, DoubleDOS INT SEh 


INTERRUPT 0Eh 
EXTERNAL CARD INTERRUPT 


Purpose: Indicates that a peripheral card requires attention. 

Available on: HP 95LX only. Restrictions: none. 
Registers at call: n/a Return Registers: n/a 
Conflicts: Page Fault, Diskette Controller. 


INTERRUPT 0Fh 
IRQ7 - PARALLEL PRINTER 


Purpose: Generated by the LPT1 printer adapter when printer becomes ready. 

Available on: All machines. Restrictions: none. 

Registers at call: n/a Return Registers: n/a 

Details: Most printer adapters do not reliably generate this interrupt. The 8259 interrupt controller generates an 
interrupt corresponding to IRQ7 when an error condition occurs. 

Conflicts: HP 95LX real-time clock. 

See Also: LPT2 INT 0Dh, DESQview INT 57h, DoubleDOS INT 5Fh 


INTERRUPT OFh 

REAL-TIME CLOCK 

Purpose: Generated by the real-time clock in the HP 95LX. 

Available on: HP 95LX only. Restrictions: none. 
Registers at call: n/a Return Registers: n/a 


Conflicts; IRQ7. 
See Also: LPT2 INT 0Dh, DESQview INT 57h, DoubleDOS INT 5Fh 


INTERRUPT 10h 
CPU-generated - COPROCESSOR ERROR 


Purpose: Generated by the CPU when the -ERROR pin is asserted by the coprocessor. 
Available on: 80286 and above. Restrictions: none. 
Registers at call: n/a Return Registers: n/a 
Details: AT's and clones usually wire the coprocessor to use IRQ13, but not all get it right. 
Conflicts: BIOS Video interface (chapter 5). 

See Also: CPU-generated INT 09h, INT 75h 


INTERRUPT 17h 
CPU-generaied - ALIGNMENT CHECK 


Purpose: Traps reference to mis-aligned memory address. 

Available on: 80486 and above. Restrictions: Only available in privilege mode 3. 
Registers at call: n/a Return Registers: n/a 

Details: Bit AC in the EFLAGS register enables this interrupt on a memory reference on a mis-aligned address when 
in privilege mode 3. 

Conflicts: BIOS System Info (chapter 3). 


INTERRUPT 40h 
2100 - Master 8259 - Parity error or $100 error 


Purpose: Indicates error detected. 


Available on: Heath-Zenith Z100 only. Restrictions: none. 
Registers at call; n/a Return Registers: n/a 
Conflicts: Relocated diskette handler (chapter 6) 

INTERRUPT 41h 


2100 - Master 8259 - Processor Swap 
Purpose: Requests swap to alternate processor. 


Available on: Heath-Zenith Z100 only. Restrictions: none. 
Registers at call: n/a Return Registers: n/a 
Conflicts: Hard Disk Drive Parameter Table (chapter 6) 

INTERRUPT 42h 


2100 - Master 8259 - Timer 
Purpose: Indicates timer rundown. 


Available on: Heath-Zenith Z100 only. Restrictions: none. 
Registers at call: n/a Return Registers: n/a 
Conflicts: Relocated default INT 10h (chapter 5) 

INTERRUPT 43h 


2100 - Master 8259 - Slave 8259 input 

Purpose: Chains slave PIC into master, 

Available on: Heath-Zenith Z100 only. Restrictions: none. 
Registers at call: n/a Return Registers: n/a 
Details: Slave runs in a special fully-nested mode. 

Conflicts: Video Character Table (chapter 5) 


INTERRUPT 44h 
2100 - Master 8259 - Serial A 


Purpose: Indicates that serial port A needs attention. 
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Available on: Heath-Zenith Z100 only. Restrictions: none. 

Registers at call: n/a Return Registers: n/a 

Conflicts: PCjr character font vector (chapter 5), IBM 3270-PC API (chapter 26), Novell Netware HLL API (chapter 
20). 

INTERRUPT 45h 


2100 - Master 8259 - Serial B 
Purpose: Indicates that serial port B needs attention. 


Available on: Heath-Zenith Z100 only. Restrictions: none. 
Registers at call: n/a Return Registers: n/a 
Conflicts: None known. 

INTERRUPT 46h 


2100 - Master 8259 - Keyboard, Retrace, and Light Pen 


Purpose: Indicates attention needed by keyboard or light pen. 

Available on: Heath-Zenith Z100 only. Restrictions: none. 
Registers at call: n/a Return Registers: n/a 
Conflicts: Hard Disk Drive Parameter Table (chapter 6) 
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INTERRUPT 47h 
2100 - Master 8259 - Printer 


Purpose: Indicates that the printer needs attention. 


Available on: Heath-Zenith Z100 only. 
Registers at call: n/a 
Conflicts: SQL Base API (chapter 36). 


INTERRUPT 48h 
2100 - Slave 8259 - $100 vectored line 0 


Purpose: Service request from S100 bus line 0. 


Available on: Heath-Zenith Z100 only. 
Registers at call; n/a 
Conflicts: None known. 


INTERRUPT 49h 
2100 - Slave 8259 - $100 vectored line 1 


Purpose: Service request from $100 bus line 1. 


Available on: Heath-Zenith Z100 only. 
Registers at call: n/a 
Conflicts: MAGic (chapter 36) 


INTERRUPT 4Ah 
2100 - Slave 8259 - $100 vectored line 2 


Purpose: Service request from $100 bus line 2. 


Available on: Heath-Zenith Z100 only. 
Registers at call: n/a 
Conflicts: Standard BIOS INT 4Ah (chapter 3) 


INTERRUPT 4Bh 
2100 - Slave 8259 - $100 vectored line 3 


Purpose: Service request from $100 bus line 3. 


Available on: Heath-Zenith 2100 only. 
Registers at call: n/a 


Restrictions: none. 
Return Registers: n/a 


Restrictions: none. 
Return Registers: n/a 


Restrictions: none. 
Return Registers: n/a 


Restrictions: none. 
Return Registers: n/a 


Restrictions: none. 
Return Registers: n/a 


Conflicts: IBM SCSI Interface (chapter 6), Virtual DMA Specification (chapter 12) 


INTERRUPT 4Ch 
2100 - Slave 8259 - $100 vectored line 4 


Purpose: Service request from $100 bus line 4. 


Available on: Heath-Zenith Z.100 only. 
Registers at call: n/a 
Conflicts: None known, 


INTERRUPT 4Dh 
2100 - Slave 8259 - $100 vectored line 5 


Purpose: Service request from S100 bus line 5. 


Available on: Heath-Zenith Z100 only. 
Registers at call: n/a 
Conflicts: None known. 


INTERRUPT 4Eh 
2100 - Slave 8259 - S100 vectored line 6 


Purpose: Service request from $100 bus line 6. 


Restrictions: none. 
Return Registers: n/a 


Restrictions: none. 
Return Registers: n/a 
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Available on: Heath-Zenith Z100 only. Restrictions: none. 
Registers at call: n/a Return Registers: n/a 
Conflicts: None known. 

INTERRUPT 4Fh 


2100 - Slave 8259 - $100 vectored line 7 
Purpose: Service request from $100 bus line 7. 


Available on: Heath-Zenith Z100 only. Restrictions: none. 
Registers at call: n/a Return Registers: n/a 
Conflicts: None known. 

INTERRUPT 50h 

DESQview IRQO 


Purpose: IRQO relocated by DESQview. 

Details: The vectors 50h to 57h listed here are the location used by older versions of DESQview. DESQview 
versions 2.26 and higher search for unused ranges of interrupts and use the lowest available range in the search list 
for relocating these IRQs and the next lowest for relocating IRQ8-IRQI5. A range of eight interrupts starting at a 
multiple of 8 is considered available for this use if all vectors are identical. 

The list of ranges for v2.26 is 50h,58h,68h,78h,F8h; if none of these are available, F8h and then 50h are used 
anyway. The list of ranges for v2.31 is 68h,78h,88h-B8h,F8h; if none of these are available, F8h and then FOh are 
used anyway. 

Conflicts: IBM 3278 emulator IRQO, OS/2 IRQO, TIL Expert AIM (chapter 27). 
See Also: INT 08h 


INTERRUPT 50h 
IBM 3278 emulator IRQO 


Purpose: IRQO relocated by IBM 3278 emulation control program, 
Conflicts: DESQview IRQO, OS/2 IRQO, TIL Expert AIM (chapter 27). 
See Also: INT 08h 


INTERRUPT 50h 
OS/2 v1.x IRQO 


Purpose: IRQO relocated by OS/2 versions 1.x. 


Conflicts: DESQview IRQO, IBM 3278 IRQO, TIL Expert AIM (chapter 27). 
See Also: INT 08h 


INTERRUPT 51h 

DESQview IRQ? 

Purpose: IRQ1 relocated by DESQview. 
Conflicts: IBM 3278 emulator IRQI, OS/2 IRQI. 
See Also: INT 09h, DESQview INT 50h 


INTERRUPT 5th 
IBM 3278 emulator IRQ1 


Purpose: IRQ] relocated by IBM 3278 emulation control program. 
Conflicts: DESQview IRQI, OS/2 IRQI. 
See Also: INT 09h 


INTERRUPT 51h 


08/2 v1.x IRQ1 


Purpose: IRQI relocated by OS/2 versions 1.x. 
Conflicts: DESQview IRQ1, IBM 3278 emulator IRQI. 
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See Also: INT 09h 


INTERRUPT 52h 

DESQview IRQ2 

Purpose: IRQ2 relocated by DESQview. 
Conflicts: IBM 3278 emulator IRQ2, OS/2 IRQ2. 
See Also: INT 0Ah, DESQview INT 50h 


INTERRUPT 52h 
IBM 3278 emulator IRQ2Z 


Purpose: IRQ2 relocated by IBM 3278 emulation control program. 


Conflicts: DESQview IRQ2, OS/2 IRQ2. 
See Also: INT OAh 


INTERRUPT 52h 
OS/2 vi.x IRQ2 


Purpose: IRQ2 relocated by OS/2 versions 1.x. 


Conflicts: DESQview IRQ2, IBM 3278 emulator IRQ2. 
See Also: INT OAh 


INTERRUPT 53h 

DESQview IRQ3 

Purpose: IRQ3 relocated by DESQview. 
Conflicts: IBM 3278 emulator IRQ3, OS/2 IRQ3. 
See Also: INT OBh, DESQview INT 50h 


INTERRUPT 53h 
IBM 3278 emulator IRQ3 





Purpose: IRQ3 relocated by IBM 3278 emulation control program. 


Conflicts: DESQview IRQ3, OS/2 IRQ3. 
See Also: INT OBh 


INTERRUPT 53h 
OS/2 v1.x IRQ3 


Purpose: IRQ3 relocated by OS/2 versions 1.x. 


Conflicts: DESQview IRQ3, IBM 3278 emulator IRQ3. 
See Also: INT OBh 


INTERRUPT 54h 

DESQview IRQ4 

Purpose: IRQ4 relocated by DESQview. 
Conflicts: IBM 3278 emulator IRQ4, OS/2 IRQ4. 
See Also: INT 0Ch, DESQview INT 50h 


INTERRUPT 54h 
IBM 3278 emulator IRQ4 


Purpose: IRQ4 relocated by IBM 3278 emulation control program. 


Conflicts: DESQview IRQ4, 08/2 IRQ4. 
See Also: INT 0Ch 
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INTERRUPT 54h 

08/2 vi.x IRQ4 

Purpose: IRQ4 relocated by OS/2 versions 1.x. 
Conflicts: DESQview IRQ4, IBM 3278 emulator IRQ4. 
See Also: INT 0Ch 


INTERRUPT 55h 

DESQview IRQ5 

Purpose: IRQS relocated by DESQview. 
Conflicts: IBM 3278 emulator IRQ5, OS/2 IRQS. 
See Also: INT 0Dh, DESQview INT 50h 


INTERRUPT 55h 

IBM 3278 emulator IRQS 

Purpose: IRQS relocated by IBM 3278 emulation control program. 
Conflicts: DESQview IRQS, OS/2 IRQS. 

See Also: INT 0Dh 


INTERRUPT 55h 
OS/2 v1.x IRQS 
Purpose: IRQS relocated by OS/2 versions 1.x. 

Conflicts: DESQview IRQS, IBM 3278 emulator IRQS. 
See Also: INT ODh 


INTERRUPT 56h 
DESQview IRQ6 
Purpose: IRQ6 relocated by DESQview. 
Conflicts: [BM 3278 emulator IRQ6, OS/2 IRQ6. 
See Also: INT 0Eh, DESQview INT 50h 


INTERRUPT 56h 

IBM 3278 emulator IRQ6 

Purpose: IRQ6 relocated by IBM 3278 emulation control program, 
Conflicts: DESQview IRQ6, OS/2 IRQ6. 

See Also: INT OEh 


INTERRUPT 56h 

OS/2 v1.x ROC 

Purpose: IRQ6 relocated by OS/2 versions 1.x. 
Conflicts: DESQview IRQ6, IBM 3278 emulator IRQ6. 
See Also: INT OEh 


INTERRUPT 57h 

DESQview IRQ7 

Purpose: IRQ7 relocated by DESQview. 
Conflicts: IBM 3278 emulator IRQ7, OS/2 IRQ7. 
See Also: INT OFh, DESQview INT 50h 


INTERRUPT 57h 
IBM 3278 emulator IRQ7 


Purpose: IRQ7 relocated by IBM 3278 emulation control program, 
Conflicts: DESQview IRQ7, OS/2 IRQ7. 
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See Also: INT OFh 


INTERRUPT 57h 

OS/2 v1.x IRQ7 

Purpose: IRQ7 relocated by OS/2 versions 1.x. 
Conflicts: DESQview IRQ7, IBM 3278 emulator IRQ7. 
See Also: INT OFh 


INTERRUPT 58h 

DoubleDOS IRQ0O 

Purpose: IRQO relocated by DoubleDOS 
Conflicts: DESQview 2.26+ IRQ8 

See Also: INT 08h 


INTERRUPT 58h 

DESQview IRQ8 

Purpose: IRQ8 relocated by DESQview 2.26+ 
Conflicts: DoubleDOS IRQO 

See Also: INT 70h, DESQview INT 50h 


INTERRUPT 59h 

DoubleDOS IRQ1 

Purpose: IRQ] relocated by DoubleDOS 

Conflicts: DESQview 2.26+ IRQ8, GSS*CGI (chapter 5) 
See Also: INT 09h 


INTERRUPT 59h 
DESQview IRQ9 


Purpose: IRQ9 relocated by DESQview 2.26+ 
Conflicts: DoubleDOS IRQ1, GSS*CGI (chapter 5) 
See Also: INT 71h, DESQview INT 50h 


INTERRUPT 5Ah 
DoubleDOS IRQ2 


Purpose: IRQ2 relocated by DoubleDOS 


Conflicts: DESQview 2.26+ IRQ10, Cluster adapter BIOS (Chapter 27). 


See Also: INT 0OAh 


INTERRUPT 5Ah 
DESQview IRQ10 


Purpose: IRQ1O0 relocated by DESQview 2.26+ 
Conflicts: DoubleDOS IRQ2, Cluster adapter BIOS (Chapter 27). 
See Also: INT 72h, DESQview INT 50h 


INTERRUPT 5Bh 
DoubleDOS IRQ3 


Purpose: IRQ3 relocated by DoubleDOS. 


Conflicts: DESQview IRQI1; AT&T Starlan Extended NetBIOS, Microsoft Network Transport Layer Interface, and 


cluster adapter (chapter 27). 
See Also: INT OBh 
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INTERRUPT 5Bh 
DESQview IRQ11 


Purpose: IRQ! 1 relocated by DESQview 2.26+. 

Conflicts: DoubleDOS IRQ3; AT&T Starlan Extended NetBIOS (chapter 27), Microsoft Network Transport Layer 
Interface (chapter 27), cluster adapter (chapter 27). 

See Also: INT 73h, DESQview INT 50h 


INTERRUPT 5Ch 
DoubleDOS IRQ4 


Purpose: IRQ4 relocated by DoubleDOS. 
Conflicts: DESQview IRQ12; $25 LAN, ATALK.SYS, IBM 802.2 interface (LLC), NetBIOS interface, and TOPS 


interface (chapter 27). 
See Also: INT 0Ch 


INTERRUPT 5Ch 

DESQview IRQ12 

Purpose: IRQ12 relocated by DESQview 2.26+. 

Conflicts: DoubleDOS IRQ4; $25 LAN, ATALK.SYS, IBM 802.2 interface (LLC), NetBIOS interface, and TOPS 
interface (chapter 27). 

See Also: INT 74h, DESQview INT 50h 


INTERRUPT 5Dh 

DoubleDOS IRQS 

Purpose: IRQS relocated by DoubleDOS. 
Conflicts: IRQI3 relocated by DESQview 2.26+. 
See Also: INT ODh 


INTERRUPT 5Dh 
DESQview IRQI3 


Purpose: IRQ13 relocated by DESQview 2.26+. 
Conflicts: IRQS relocated by DoubleDOS, 


“See Also: INT 75h, DESQview INT 50h 


INTERRUPT 5Eh 

DoubleDOS IRQ6 

Purpose: IRQ6 relocated by DoubleDOS. 
Conflicts: IRQ14 relocated by DESQview 2.26+. 
See Also: INT OEh 


INTERRUPT 5Eh 

DESQview IRQ14 

Purpose: IRQ14 relocated by DESQview 2.26+. 
Conflicts: IRQ6 relocated by DoubleDOS. 

See Also: INT 76h, DESQview INT 50h 


INTERRUPT 5Fh 

DoubleDOS IRQ7 

Purpose: IRQ7 relocated by DoubleDOS. 

Conflicts: IRQ15 relocated by DESQview 2.26+, HP 95LX (chapter 4). 
See Also: INT OFh 
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INTERRUPT 5Fh 

DESQview IRQ1S 

Purpose: IRQ15 relocated by DESQview 2.26+. 

Conflicts: IRQ7 relocated by DoubleDOS, HP 95LX (chapter 4), 
See Also: INT 77h, DESQview INT 50h 


INTERRUPT 70h 
IRQ8 - CMOS REAL-TIME CLOCK 


Purpose: This interrupt is called when the real-time clock chip generates an alarm or periodic interrupt, among 
others, 


Available on: 80286 and above. Restrictions: Only enabled if bit 0 of I/O port Ath is 
clear. 
Registers at call: n/a Return Registers: n/a 


Details: The periodic interrupt occurs 1024 times per second, although many BJOSes turn it off in the INT 70h 
handler unless in an event wait (see INT 15h Functions 83h or 86h in chapter 3). 

Conflicts: None known. 

See Also: INT 08h, DESQview INT 58h, Amstrad INT 15h Function 01h (chapter 4), INT 15h Functions 83h and 
86h (chapter 3), INT 1Ah Function 02h (chapter 3). 


INTERRUPT 71h 


1RQ9 - REDIRECTED TO INT 0A BY BIOS 


Purpose: The default BIOS handler invokes INT 0A for compatibility, since the pin for IRQ2 on the PC expansion 
bus became the pin for IRQ9 on the AT expansion bus. 


Available on: AT and later. Restrictions: Only enabled if bit 1 of I/O port Alh is 
clear. 
Registers at call: n/a Return Registers: n/a 


Details: Under DESQview, only the INT 15h vector and BASIC segment address (the word at 0000h:0510h) may be 
assumed to be valid for the handler's process. 

Conflicts: None known. 

See Also: INT OAh, DESQview INT 59h 


INTERRUPT 72h 

1RQ10 - RESERVED 

Purpose: Reserved by IBM and not used on any current IBM models. 

Available on: AT and later. Restrictions: Only enabled if bit 2 of I/O port Alh is 
clear. 

Registers at call: n/a Return Registers: n/a 

Conflicts: None known. 

See Also: DESQview INT 5Ah 

INTERRUPT 73h 

IRQI1 - RESERVED 

Purpose: Reserved by IBM and not used on any current IBM models. 

Available on: AT and later, Restrictions: Only enabled if bit 3 of 1/O port Alh is 
clear. 

Registers at call: n/a Return Registers: n/a 


Conflicts: None known. 
See Also: DESQview INT 5Bh 


INTERRUPT 74h 
IRQ12- POINTING DEVICE 


Purpose: Attention request from mouse or other pointing device. 


Hardware Interrupts 2-17 


Restrictions: Only enabled if bit 4 of I/O port Ath is 
clear. 

Registers at call: n/a Return Registers: n/a 

Details: Under DESQview, only the INT 15h vector and BASIC segment address (the word at 0000h:0510h) may be 

assumed to be valid for the handler's process. 

Conflicts: None known. 

See Also: DESQview INT 5Ch, Mouse INT 33h (chapter 13) 


INTERRUPT 75h 
1RQ13 - MATH COPROCESSOR EXCEPTION 


Purpose: Indicates math coprocessor error. 


Available on: PS/2 series machines only. 


Available on: AT and later. Restrictions: Only enabled if bit 5 of I/O port Alh is 
clear. 
Registers at call: n/a Return Registers: n/a 


Details: Not all clones wire the coprocessor to generate this IRQ; some systems generate an NMI (see INT 02) or 
assert the -ERROR pin on the CPU (see INT 10h above). 

The BIOS handler for this interrupt invokes INT 02h for compatibility with the PC. Under DESQview, only the 
INT 15h vector and BASIC segment address (the word at 0000h:0510h) may be assumed to be valid for the handler's 
process. 

Conflicts: None known. 
See Also: CPU-generated INT 10h, DESQview INT SDh 


INTERRUPT 76h 
1RQ14 - HARD DISK CONTROLLER 


Purpose: Indicates completion of activity by HD controller. 


Available on: AT and later, Restrictions: Only enabled if bit 6 of I/O port Alh is 
clear, 

Registers at call: n/a Return Registers: n/a 

Conflicts: None known. 

See Also: Hard Disk IRQ6 on INT 0Bh, DESQview INT 5Eh 

INTERRUPT 77h 

1RQ15 - RESERVED (AT,PS) 

Purpose: Reserved by IBM and not used on any current IBM models. 

Available on: AT and PS lines only. Restrictions: Only enabled if bit 7 of I/O port Ath is 
clear. 

Registers at call: n/a Return Registers: n/a 

Conflicts: None known. 

See Also: DESQview INT 5Fh 

INTERRUPT 77h 

IRQ15 - POWER CONSERVATION (Compaq SLT/286) 

Purpose: Manage battery power by shutting down unused peripherals, 

Available on: Compaq SLT/286 only. Restrictions: Only enabled if bit 7 of I/O port Alh is 
clear. 

Registers at call: n/a Return Registers: n/a 


Conflicts: None known. 
See Also: Compaq INT 15h Function 46h Subfunction 00h (chapter 4), DESQview INT 5Fh 
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This chapter deals primarily with the "standard" ROM-BIOS interfaces first established by the original IBM PC. It 
also includes several additional calls that appear to be more closely related to these interfaces than to any other func- 


INTERRUPT 05h 
PRINT SCREEN 
Purpose: Transmits the current contents of the text sereen to the printer (it may also dump graphics images if a spe- 


cial driver is loaded). 
Available on: All machines. Restrictions: none. 


Registers at call: n/a 


Return Registers: n/a 


Details: This interrupt is normally invoked by the INT 09h handler when PrtSc key is pressed, but may be invoked di- 
rectly by applications, The default handler is at FO0Oh:FF54h in IBM PC and 100%-compatible BlOSes. Byte at 
0050h:0000h contains status used by default handler: 


00h not active 
OL PrtSe in progress 
FFh last PrtSc encountered error 


Conflicts: CPU-generated Bound Range Exceeded fault (chapter 2). 
See Also: INT 10h Function 12h Subfunction 20h (chapter 5) 





INTERRUPT 11h 

GET EQUIPMENT LIST 

Purpose: Determine system configuration. 

Available on: All machines. Restrictions: none. 
Registers at call: n/a Return Registers: 


AX = BIOS equipment list word (Table 3-1) 


Table 3-1. Format of BIOS Equipment List Word 


Bits 
0 
1 
2,3 


Description 

floppy disk(s) installed (see bits 6-7) 

80x87 coprocessor installed 

number of 16K banks of RAM on motherboard (PC only) 
number of 64K banks of RAM on motherboard (XT only) 
pointing device installed (PS) 


unused (PS) 

initial video mode 

00 EGA, VGA, or PGA 
01 40x25 color 

10 80x25 color 

Al 80x25 monochrome 


number of floppies installed less | (if bit 0 set) 

DMA support installed (PCjr, some Tandy 1000s, 1400LT) 
number of serial ports installed 

game port installed 
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Table 3-1. Format of BIOS Equipment List Word (continued) 


Bits Description 
13 serial printer attached (PCjr) 

internal modem installed (PC/Convertible) 
14-15 number of parallel ports installed 


The following 32-bit extensions are used by Compaq and many other 386/486 machines: 
EAX bit 23: page tables set so that Weitek coprocessor addressable in real mode 
bit 24: Weitek math coprocessor present 


Compaq Systempro: 
EAX bit 25: internal DMA parallel port available 
bit 26: IRQ for internal DMA parallel port (if bit 25 set) 
0 =IRQ5 
1=IRQ7 
27,28: parallel port DMA channel 
00 = DMA channel 0 
01 = DMA channel 0 
10 = reserved 
11=DMA channel 3 
Conflicts: Alignment Check fault (chapter 2), Back&Forth (chapter 17). 
See Also: INT 12h 


INTERRUPT 12h 

GET MEMORY SIZE 

Purpose: Determine the amount of contiguous memory installed in the system. 

Available on: All machines. Restrictions: none. 

Registers at call: n/a Return Registers: AX = kilobytes of contiguous 


memory starting at absolute address 00000h. 
Details: This call returns the contents of the word at 0040h:0013h; in PC and XT, this value is set from the switches 
on the motherboard. 
Conflicts: Back&Forth (chapter 17). 
See Also: INT 11h 


INTERRUPT 15h - Function 00h 
CASSETTE - TURN ON TAPE DRIVE MOTOR 


Purpose: Turns tape cassette motor ON. 


Available on: PC and PCjr only. Restrictions: none. 
Registers at call: Return Registers: 
AH = 00h CF set on error 


AH = 86h no cassette present 
CF clear if successful 
Conflicts; Amstrad PC1512 (chapter 4), MultiDOS Plus (chapter 16), VMiX (chapter 17). 
See Also: Function 01h 


INTERRUPT 15h - Function 01h 
CASSETTE - TURN OFF TAPE DRIVE MOTOR 


Purpose: Turns tape cassette motor OFF. 


Available on: PC and PCjr only. Restrictions: none. 
Registers at call: Return Registers: 
AH = Oth CF set on error 


AH = 86h no cassette present 
CF clear if successful 
Conflicts: Amstrad PC1512 (chapter 4), MultiDOS Plus (chapter 16), VMiX (chapter 17). 
See Also: Function 00h 
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INTERRUPT 15h - Function 02h 


CASSETTE - READ DATA 

Purpose: Read data from cassette. 

Available on: PC and PCjr only. Restrictions: none. 

Registers at call: Return Registers: 

AH = 02h CF clear if successful 

CX = number of bytes to read DX = number of bytes read 

ES:BX -> buffer ES:BX -> byte following last byte read 


CF set on error 
AH & status 
00h successful 
Oih CRC error 
02h bad tape signals 
04h no data 
80h invalid command 
86h no cassette present 
Conflicts: Amstrad PC1512 (chapter 4), MultiDOS Plus (chapter 16), WMiX (chapter 17). 
See Also: Functions 00h and 03h 


INTERRUPT 15h - Function 03h 
CASSETTE - WRITE DATA 


Purpose: Writes data to cassette tape. 


Available on: PC and PCjr only. Restrictions: none. 
Registers at call: Return Registers: 
AH = 03h CF clear if successful 
CX = number of bytes to write ES:BX -> byte following last byte written 
ES:BX -> data buffer CF set on error 
AH = status (see Function 02h) 
CX = 0000h 


Conflicts: Amstrad PC1512 (chapter 4), MultiDOS Plus (chapter 16), VMiX (chapter 17). 
See Also: Functions 00h and 02h 


INTERRUPT 15h - Function 04h 
SYSTEM - BUILD ABIOS SYSTEM PARAMETER TABLE 


Purpose: Prepare for OS/2 operation using the Advanced BIOS. 


Available on: PS models only, Restrictions: none. 

Registers at call: Return Registers: 

AH = 04h AH = 00h success: results at ES:DI 
ES:DI -> results buffer length 20h for System CF set on failure 


Parameter Table (Table 3-2) 
DS = segment containing ABIOS RAM extensions 
(zero if none) 
Conflicts: Amstrad PC1512 (chapter 4), MultiDOS Plus (chapter 16), VMiX (chapter 17). 
See Also: Functions 0Sh and Clh 





Table 3-2. Format of ABIOS System Parameter Table 


Offset Size Description 

00h DWORD _ FAR address of ABIOS Common Start Routine 

04h DWORD _ FAR address of ABIOS Interrupt Routine 

08h DWORD _ FAR address of ABIOS Time-out Routine 

0Ch WORD number of bytes of stack required by this ABIOS implementation 
OEh 16 BYTEs reserved 





1Eh WORD number of entries in initialization table 
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INTERRUPT 15h - Function 05h 
SYSTEM - BUILD ABIOS INITIALIZATION TABLE 


Purpose: Prepare for OS/2 operation using the Advanced BIOS. 


Available on: PS/2 models only. Restrictions: none. 

Registers at call: Return Registers: 

AH = 05h AH = 00h success: results at ES:DI 
ES:DI -> results buffer length CF set on failure 


(18h * Number_of_Entries) 
DS = segment containing ABIOS RAM extensions 

(zero if none) 
Conflicts: Amstrad PC1512 (chapter 4), MultiDOS Plus (chapter 16), VMiX (chapter 17). 
See Also: Functions 04h and Clh 


Table 3-3. Format of one entry of ABIOS Initialization Table 


Offset Size Description 

00h WORD device ID 

02h WORD number of Logical IDs 

04h WORD Device Block length (zero for ABIOS patch or extension) 

06h DWORD _ Far pointer to init routine for Device Block and Function Transfer Table 
OAh WORD request block length 

OCh WORD Function Transfer Table length (zero for a patch) 

OEh WORD Data Pointers length (in Common Data Area) 

10h BYTE secondary device ID (hardware level this ABIOS ver supports) 
lth BYTE revision (device driver revision level this ABIOS supports) 
12h 6BYTEs reserved 


INTERRUPT 15h - Function OFh 
SYSTEM - FORMAT UNIT PERIODIC INTERRUPT 


Purpose: Called during ESDI drive formatting after each cylinder is completed to determine whether to continue. 


Available on: PS/2 models with ESDI drives only. Restrictions: none. 
Registers at call: Return Registers: 
AH = OFh CF clear if formatting should continue, 
AL = phase code CF set if it should terminate, 
00h reserved 


Olh surface analysis 

02h formatting 
Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17). 
See Also: ESDI Hard Disk INT 13h Function 1 Ah (chapter 6) 


INTERRUPT 15h - Function 20h, Subfunction 10h 
OS HOOK - SETUP SYSREQ ROUTINE 


Purpose: unknown. 


Available on: DOS 3.0 and higher. Restrictions: none. 
Registers at call: Return Registers: unknown 
AX = 2010h 


other inputs, if any, unknown 
Conflicts: MultiDOS Plus (chapter 16). 
See Also: Function 20h Subfunction 11h 


INTERRUPT 15h - Function 20h, Subfunction 11h 
OS HOOK - COMPLETION OF SYSREQ FUNCTION 


Purpose: unknown. 
Available on: AT, XT286, PSS0+. Restrictions: none. 
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Registers at call: Return Registers: unknown 
AX = 201 1h 

other inputs, if any, unknown 

Conflicts: MultiDOS Plus (chapter 16). 

See Also: Function 20h Subfunction 10h 


INTERRUPT 15h - Function 21h 
SYSTEM - POWER-ON SELF-TEST ERROR LOG 


Purpose: Reads from or writes to Power On Self Test error log. 


Available on: PS/2 Model 50 and above. Restrictions: none. 
Registers at call: Return Registers: 
AH = 2th CF set on error 
AL = subfunction: AH = status 

00h read POST log 00h OK 

Oth write POST log O1h list full 
BH = device ID 80h invalid cmd 
BL = error code 86h unsupported 

if function 00h: 


BX = number of error codes stored 
ES;D] -> error log 


Details: The log is a series of words, the first byte of which identifies the error code and the second the device. 


Conflicts: None known. 


INTERRUPT 15h - Function 40h 
SYSTEM - READ/MODIFY PROFILES 


Purpose: Read from or write to system or modem profile words. 


Available on: Convertible only. Restrictions: none. 
Registers at call: Return Registers: n/a 
AH = 40h 


AL = subfunction 
00h get system profile in CX and BX 
OLh set system profile from CX and BX 
02h get internal modem profile in BX 
03h set internal modem profile from BX 
Conflicts: Compaq SLT/286 or Portable 386 (chapter 4). 


INTERRUPT 15h - Function 41h 
SYSTEM - WAIT ON EXTERNAL EVENT 


Purpose: Pause execution of calling application until a specified event occurs. 


Available on: Convertible only. Restrictions: none. 
Registers at call: Return Registers: n/a 
AH = 41h 


AL = condition type 

bits 0-2: condition to wait for 
0 any external event 
1 compare and return if equal 
2 compare and return if not equal 
3 test and return if not zero 
4 test and return if zero 

bit 3: reserved 

bit 4: [=port address, 
O=user byte 

bits 5-7: reserved 
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BH = condition compare or mask value 

BL = timeout value times 55 milliseconds 
00h means no timeout 

DX = /O port address if AL bit 4 set 

ES:DI -> user byte if AL bit 4 clear 

Conflicts: None known. 


INTERRUPT 15h - Function 42h 
SYSTEM - REQUEST POWER OFF 


Purpose: Turn off the system under software control. 


Available on: Convertible only. Restrictions: none. 
Registers at call: Return Registers: n/a 
AH = 42h 


AL = 00h to use system profile 
O1h to force suspend regardless of 
system profile 
Conflicts: Compaq SLT/286 (chapter 4). 
See Also: Function 44h 


INTERRUPT 15h - Function 43h 
SYSTEM - READ SYSTEM STATUS 


Purpose: Determine state of power supply and which devices are currently turned on. 


Available on: Convertible only. Restrictions: none. 
Registers at call: Return Registers: 
AH =43h AL = status bits 


bit 0: LCD detached 
bit 1: reserved 
bit 2: RS232/parallel adapter powered on 
bit 3: internal modem powered on 
bit 4: power activated by alarm 
bit 5: standby power lost 
bit 6: external power in use 
bit 7: power low 
Conflicts: None known. 


INTERRUPT 15h - Function 44h 
SYSTEM - (DE)ACTIVATE INTERNAL MODEM POWER 


Purpose: Turn internal modem on or off under software control. 


Available on: Convertible only. Restrictions: none. 
Registers at call: Return Registers: n/a 
AH = 44h 


AL = 00h to power off 
O1h to power on 
Conflicts: None known, 
See Also: Function 42h 


INTERRUPT 15h - Function 4Fh 
OS HOOK - KEYBOARD INTERCEPT 


Purpose: Permits an application or TSR to remap the keys on the keyboard before the BIOS decodes keypresses. 


Available on: PC-AT models 3x9, XT2, XT286, Restrictions: none. 
Convertible, PS/2 series. 
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Registers at call: Return Registers: 
AH = 4Fh CF set 

AL = scan code AL = scan code 
CF set CF clear 


scan code should be ignored 
Details: Called by INT 09h handler to translate scan codes. 
Conflicts: None known. 
See Also: INT 09h (chapter 2) 


INTERRUPT 15h - Function 80h 
OS HOOK - DEVICE OPEN 


Purpose: Notify the operating system that an application will be using a particular device. 


Available on: AT and later. Restrictions: none 
Registers at call: Return Registers: 
AH = 80h CF clear if successful 
BX = device ID AH = 00h 

CX = process ID 

CF clear 


CF set on error 
AH = status 
80h invalid command (PC, PCjr) 
86h function not supported (XT and later) 
Details: This function should be hooked by a multitasker which wishes to keep track of device ownership; the 
default BIOS handler merely returns successfully. 
Conflicts: None known, 
See Also: Functions 81h and 82h 


INTERRUPT 15h - Function 81h 


OS HOOK - DEVICE CLOSE 

Purpose: Notify the operating system that an application is finished with its use of a particular device, 
Available on: AT and later. Restrictions: none 

Registers at call: Return Registers: 

AH = 81h CF clear if successful 

BX = device ID AH = 00h 

CX = process ID CF set on error 

CF clear AH = status 


80h invalid command (PC, PCjr) 

86h function not supported (XT and later) 
Details: This function should be hooked by a multitasker which wishes to keep track of device ownership; the 
default BIOS handler merely returns successfully. 
Conflicts: None known. 
See Also: Functions 80h and 82h 


INTERRUPT 15h - Function 82h 
OS HOOK - PROGRAM TERMINATION 


Purpose: Closes all devices opened by the given process ID with function 80h. 


Available on: AT and later. Restrictions: none 
Registers at call: Return Registers: 
AH = 82h CF clear if successful 
BX = process ID AH = 00h 


CF clear 
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CF set on error 
AH = status 
80h invalid command (PC, PCjr) 
86h function not supported (XT and later} 
Details: This function should be hooked by a multitasker which wishes to keep track of device ownership; the 
default BIOS handler merely returns successfully. 
Conflicts: None known. 
See Also: Functions 80h and 81h 


INTERRUPT 15h - Function 83h 


SET EVENT WAIT INTERVAL 

Purpose: Establishes the duration of a wait period, at the end of which a user-specified flag is set. 

Available on: PC-AT, PS/2 Model 50 and above. Restrictions: none. 

Registers at call: Return Registers: 

AH = 83h CF set on error or function already busy 

AL = subfunction AH = status 

OOh set interval 80h invalid command (PC, PCjr) 

CX:DX = microseconds to delay 86h function not supported (XT and later) 
ES:BX -> byte whose high bit is to CF clear if successful 


be set at end of interval 
Oth cancel wait interval 
Details: The resolution of the wait period is 977 microseconds on most systems because most BIOSes use the 1/1024 
second fast interrupt from the AT real-time clock chip which is available on INT 70h. 
Conflicts: None known, 
See Also: Function 86h, IRQ8 on INT 70h (chapter 2) 


INTERRUPT 15h - Function 84h 


JOYSTICK SUPPORT 
Purpose: Provides BIOS support for up to 2 joysticks, 
Available on: XT with BIOS date after 11/8/82, Restrictions: none. 
PC-AT, XT286, and PS/2 models, 
Registers at call: Return Registers: 
AH = 84h CF set on error 
DX = subfunction AH = status 
0000h read joystick switches 80h invalid command (PC, PCjr) 
000 1h read positions of joysticks 86h function not supported (other) 


CF clear if successful 
AL bits 7-4 = switch settings for subfunction 0000 
AX = X position of joystick A for subfunction 
0001 

BX = Y position of joystick A 

CX = X position of joystick B 

DX = Y position of joystick B 
Details: If no game port is installed, subfunction 0000h returns AL=00h (all switches open) and subfunction 0001h 
returns AX=BX=CX=DX=0000h. A 250kOhm joystick typically returns OQO0Qh-01 AOh. 


INTERRUPT 15h - Function 85h 
OS HOOK - SysRq KEY ACTIVITY 


Purpose: Provides hook to monitor SysRq key. 


Available on: PC-AT, PS/2. Restrictions: none. 
Registers at call: Return Registers: 
AH = 85h CF clear if successful 


AH = 00h 
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AL = 00h SysRq key pressed CF set on error 
= Oth SysRq key released AH = status 
CF clear 80h invalid command (PC, PCjr) 


86h function not supported (other) 
Details: Called by keyboard decode routine. The default handler simply returns successfully; programs which wish 
to monitor the SysRq key must hook this call. 
Conflicts: None known. 
See Also: INT 09h (chapter 2) 


INTERRUPT 15h - Function 86h 


WAIT 

Purpose: Delay execution for a specified period of time. 

Available on: PC-AT, PS/2. Restrictions: none. 

Registers at call: Return Registers: 

AH = 86h CF clear if successful (wait interval elapsed) 
CX:DX = interval in microseconds CF set on error 


AH = status 

80h invalid command (PC, PCjr) 

83h wait already in progress 

86h function not supported (other) 
Details: The resolution of the wait period is 977 microseconds on most systems because most BIOSes use the 1/1024 
second fast interrupt from the AT real-time clock chip which is available on INT 70h. 
Conflicts: None known. 
See Also: Function 83h, IRQ8 on INT 70h (chapter 2) 


INTERRUPT 15h - Function 87h 
SYSTEM » COPY EXTENDED MEMORY 


Purpose: Copies a block of data via parameters passed in a global descriptor table. 


Available on: PC-AT, PS/2. Restrictions: none. 

Registers at call: Return Registers: 

AH = 87h CF set on error 

CX = number of words to copy (max 8000h) CF clear if successful 

ES:SI -> global descriptor table (Table 3-4) AH = status 
00h source copied into destination 
Olh parity error 


02h interrupt error 

03h address line 20 gating failed 

80h invalid command (PC, PCjr) 

86h unsupported function (XT, PS30) 
Details: Copy is done in protected mode with interrupts disabled. 
Conflicts: This function is incompatible with the OS/2 compatibility box. 
See Also: Functions 88h and 89h 


Table 3-4. Format of global descriptor table: 


Offset Size Description 

00h 16 BYTEs zeros 

10h WORD source segment length in bytes (2*CX-I or greater) 

12h 3BYTEs 24-bit linear source address, low byte first 

15h BYTE source segment access rights (93h) 

16h WORD zero 

18h WORD destination segment length in bytes (2*CX-1 or greater) 


1Ah 3BYTEs 24-bit linear destination address, low byte first 
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Table 3-4, Format of global descriptor table (continued) 


Offset Size Description 
1Dh BYTE destination segment access rights (93h) 
1Eh 18 BYTEs zeros 


INTERRUPT 15h - Function 88h 
SYSTEM - GET EXTENDED MEMORY SIZE 


Purpose: Returns amount of extended memory available, in kilobytes. 


Available on: PC-AT, XT286, PS/2 models with Restrictions: none. 
80286 or above. 

Registers at call: Return Registers: 

AH = 88h CF clear if successful 


AX = number of contiguous KB starting at 
absolute address 100000h 
CF set on error 
AH = status 
80h invalid command (PC, PCjr) 
86h unsupported function (XT, PS30) 
Details: TSRs which wish to allocate extended memory to themselves often hook this call, and return a reduced 
memory size. They are then free to use the memory between the new and old sizes at will. 
Conflicts: None known, 
See Also: Function 87h 


INTERRUPT 15h - Function 89h 
SYSTEM - SWITCH TO PROTECTED MODE 


Purpose: Switches system into protected mode. 


Available on: PC-AT, XT286, PS/2 models with Restrictions: none. 
80286 or above. 
Registers at call: Return Registers: 
AH = 89h CF set on error 
BL = interrupt number of IRQO AH = FFh error enabling address line 20 
(IRQ1-7 use next 7 interrupts) CF clear if successful 
BH = interrupt number of IRQ8 AH = 00h in protected mode at specified address 


(IRQ9-F use next 7 interrupts) 
ES:SI -> GDT for protected mode 
offset Oh null descriptor 
(initialize to zeros) 
08h GDT descriptor 
10h IDT descriptor 
18h DS 
20h ES 
28h SS 
30h CS 
38h uninitialized, used to build 
descriptor for BIOS CS 
CX = offset into protected-mode CS to jump to 
Details: BL and BH must be multiples of 8. 
Conflicts: None known. 
See Also: Functions 87h and 88h, VCPI INT 67h Function DEh Subfunction 0Ch (chapter 10) 


INTERRUPT 15h - Function 90h 
OS HOOK - DEVICE BUSY 


Purpose: To permit other programs to run while waiting for a busy device to become available. 
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Available on: PC-AT, PS/2, Restrictions: none. 

Registers at call: Return Registers: 

AH = 90h CF set if wait time satisfied 

AL = device type CF clear if driver must perform wait 
00h disk AH = 00h 
Olh diskette 
02h keyboard 


03h PS/2 pointing device 
21h waiting for keyboard input 
(Phoenix BIOS) 
80h network 
FCh disk reset (PS) 
FDh diskette motor start 
FEh printer 
ES:BX -> request block for type codes 80h through 
BFh 
CF clear 
Details: Type codes are allocated as follows: 
O00h-7Fh non-reentrant devices; OS must arbitrate access, 
80h-BFh reentrant devices; ES:BX points to a unique control block. 
COh-FFh wait-only calls, no complementary INT 15h Function 91h call. 
This function should be hooked by a multitasker to allow other tasks to execute while the BIOS is waiting for I/O 
completion; the default handler merely returns with AH=00h and CF clear. 
Conflicts: None known, 
See Also: Function 91h 


INTERRUPT 15h - Function 91h 


OS HOOK - DEVICE POST 

Purpose: To permit other programs to run while waiting for a busy device to become available, 
Available on: PC-AT, PS/2. Restrictions: none. 

Registers at call: Return Registers: 

AH = 91h AH=00h 


AL = device type (see Function 90h) 
ES:BX -> request block for type codes 80h through 
BFh 
CF clear 
Details: This function should be hooked by a multitasker to allow other tasks to execute while the BIOS is waiting 
for I/O completion; the default handler merely returns with AH=00h and CF clear, 
Conflicts: None known. 
See Also: Function 90h 


INTERRUPT 15h - Function COh 

SYSTEM - GET CONFIGURATION 

Purpose: Returns pointer to configuration table in ROM BIOS. 

Available on: XT after 1/10/86, PC-AT models Restrictions: see notes at end of table. 
3x9, Convertible, XT286, PS/2 
models. 
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Registers at call: Return Registers: 
AH=C0h CF set if BIOS does not support call 
CF clear on success 
ES:BX -> ROM table (Table 3-5) 
AH = status 
00h successful 
86h unsupported function 
Details: The 1/10/86 XT BIOS returns an incorrect value for the feature byte. The configuration table is at 
FO00h:E6F5h in 100% compatible BIOSes. 
Conflicts: None known. 


Table 3-5. Format of ROM configuration table 


Offset Size Description 

00h WORD number of bytes following 

02h BYTE model (see below) 

03h BYTE submodel (see below) 

04h BYTE BIOS revision: 0 for first release, 1 for second, etc. 
05h BYTE features: 


bit 7 = DMA channel 3 used by hard disk BIOS 

bit 6 = 2nd 8259 installed 

bit 5 = Real-Time Clock installed 

bit 4 = INT 15h Func 4Fh called upon INT 9h 

bit 3 = wait for external event supported 

bit 2 = extended BIOS data area allocated (usually at top of RAM) 

bit 1 = bus is Micro Channel instead of ISA 
: bit 0 reserved 
06h WORD reserved (0) 


08h WORD reserved (0) 

--AWARD BIOS 

OAh AWARD copyright notice here 

--Phoenix BIOS 

OAh BYTE BIOS major version 

OBh BYTE BIOS minor version (BCD) 

0Ch 4BYTEs ASCIZ "PTL" (Phoenix Technologies Ltd) 


Table 3-6. Values for model/submodellrevision 
Value 1 Value 2 Value 3 Date Model 
rs ‘ 


FFh 04/24/81 PC (original) 

FFh % * 10/19/81 PC (some bugfixes) 

FFh s * 10/27/82 PC (HD, 640K, EGA support) 
FFh 46h nae unknown Olivetti M15 

FEh # ® 08/16/82, PC XT 

FEh = * 11/08/82 PC XT and Portable 

FEh 43h iil unknown Olivetti M240 

FDh me by 06/01/83 PCjr 

FCh be * 01/10/84 AT models 068,099 6 MHz 20MB 
FCh 00h Olh 06/10/85 AT model 239 6 MHz 30MB 
FCh 00h <>01h unknown 7531/2 Industrial AT 

FCh Oth 00h 11/15/85 AT models 319,339 8 MHz, Enh Keyb, 3.5" 





* This BIOS call is not implemented in these early versions. Read Model byte at FOOOh:FFFEh and BIOS date at 
FOQOOh:FFFSh. 


« These Olivetti machines store the submodel in the byte at FOQOh:FFFDh., 





{ 
| 
i 
i 
i 
i 





ROM BIOS 3-13 


Table 3-6. Values for modellsubmodelirevision (continued) 


Value 1 Value 2 Value3 Date Model 




















FCh Olh 00h 01/15&88 Toshiba T5200/100 
FCh Olh 00h 12/26*89 Toshiba T1200/XE 
(Those date characters are not typos) 
FCh Olh unknown unknown Compaq 286/386 
FCh 02h 00h 04/21/86 PC XT-286 
FCh 04h 00h 02/13/87 PS/2 Model 50** 
FCh 04h 03h 04/18/88 PS/2 Model 50Z 
FCh 05h 00h 02/13/87 PS/2 Model 60** 
FCh 06h unknown unknown 7552. "Gearbox" 
FCh 09h 02h 06/28/89 PS/2 Model 30-286 
FC OBh 02/16/90 PS/I1 
FC 42h unknown Olivetti M280 
FC 45h unknown Olivetti M380 (XP I, XP 3, XP 5) 
FC 48 unknown Olivetti M290 
FCh 4Fh unknown Olivetti M250 
FCh 50 unknown Olivetti M380 (XP 7) 
FCh 31 unknown Olivetti PCS286 
FCh 52 unknown Olivetti M300 
FCh 81 01/15/88 Phoenix 386 BIOS vI.10 10a 
FBh 00h O1/10/86 PC XT, Enh Keyb, 3.5” support 
FBh 00h 05/09/86 PC XT 
FBh 4Ch unknown Olivetti M200 
FAh 00h 09/02/86 PS/2 Model 30 
FAh 00h 12/12/86 PS/2 Model 30 
FAh Olh unknown PS/2 Model 25 
FA 4E unknown Olivetti M111 
F9h 00 09/13/85 PC Convertible 
F8h 00h 03/30/87 PS/2 Model 80 16MHz** 
F8h Olh 10/07/87 PS/2 Model 80 20MHz 
F8h 04h 04/11/88 PS/2 Model 70 20MHz, type 2 system brd 
F8h 04h 03/17/89 PS/2 Model 70 20MHz, type 2 system brd 
F8h 09h unknown unknown  PS/2 Model 70 16MHz, type | system brd 
F8h 09h 02h 04/11/88 PS/2 Model 70 some models 
F8h 09h 03h 03/17/89 PS/2 Model 70 some models 
F8h OBh 00h 01/18/89 PS/2 Model P70 (8573-121) typ 2 sys brd 
F8h OBh 02h 12/16/89 PS/2 Model P70 
F8h 0Ch 00h 11/02/88 PS/2 Model 55SX 
F8h ODh unknown unknown PS/2 Model 70 25MHz, type 3 system brd 
F8h 1h 00h 10/01/90 PS/2, unknown model 
F8h 13h 00h 10/01/90 PS/2, unknown model 
F8h {4h 00h 10/01/90 PS/2 Model 90-AK9 
F8h 16h 00h 10/01/90 PS/2 Model 90-AKD 
F8h IBh 00h 10/02/89 PS/2 Model 70-486 
F8h 1Ch 00h 02/08/90 PS/2 Model 65-121 
F8h 1Eh 00h 02/08/90 PS/2, unknown model 
F8h 50h 00h unknown PS/2 Model P70 (8573) 16 MHz 
F8h 50h Olh 12/16/89 PS/2 Model P70 (8570-031) 
F8h 6lh * unknown Olivetti P500 
F8h 62h « unknown Olivetti P800 
F8h 80h oth 11/21/89 PS/2 Model 80-A21 
9Ah * Ls unknown Compaq XT/Compaq Plus 
30h unknown — unknown unknown Sperry PC 
2D) = * unknown Compaq PC/Compaq Deskpro 
** These BIOS versions require the DASDDRVR.SYS patches. 
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INTERRUPT 15h - Function Cih 
RETURN EXTENDED BIOS DATA-AREA SEGMENT ADDRESS 


Purpose: Provides segment address (only) of extended BIOS data area; the offset portion of the address is always 
0000h. 


Available on: PS/2 models. Restrictions: none. 
Registers at call: Return Registers: 
AH=Clh CF set on error 


CF clear if successful 
ES = segment of data area 
Conflicts: None known. 
See Also: Function 04h 


INTERRUPT 15h - Function C2h, Subfunction 00h 
POINTING DEVICE BIOS INTERFACE - ENABLE/DISABLE 


Purpose: To enable or disable pointing device. 


Available on: PS/2 models. Restrictions: none. 
Registers at call: Return Registers: 
AX =C200h CF set on error 
BH = 00h disable AH = status 
Olh enable 00h successful 
Olh invalid function 
02h invalid input 


03h interface error 
04h need to resend 
05h no device handler installed 
Details: This function is called by the mouse driver's initialization code if applicable; it need not be called by 
applications. 
Conflicts: None known. 
See Also: Mouse INT 33h (chapter 13) 


INTERRUPT 15h - Function C2h, Subfunction 01h 
POINTING DEVICE BIOS INTERFACE - RESET 


Purpose: Resets mouse or alternate pointing device, 


Available on: PS/2 models. Restrictions: none, 
Registers at call: Return Registers: 
AX=C201h CF set on error 
AH = status (see above) 
CF clear if successful 


BH = device ID 
Details: This function is called by the mouse driver if applicable; it need not be called by applications. 
Conflicts: None known. 
See Also: Mouse INT 33h Function 00h (chapter 13) 


INTERRUPT 15h - Function C2h, Subfunction 02h 
POINTING DEVICE BIOS INTERFACE - SET SAMPLING RATE 


Purpose: Specifies the polling rate for the mouse or other pointing device. 


Available on: PS/2 models. Restrictions: none. 
Registers at call: Return Registers: 
AX = C202h CF set on error 
BH = sampling rate AH = status 

OOh 10/second OOh successful 


Olh 20/second Olh invalid function 


ROM BIOs 
02h 40/second 02h invalid input 
03h 60/second 03h interface error 
04h 80/second 04h need to resend 
05h 100/second 05h no device handler installed 
06h 200/second 


Details: This function is called by the mouse driver if applicable; it need not be called by applications. 
Conflicts: None known. 
See Also: Mouse INT 33h Function 1Ch (chapter 13) 


INTERRUPT 15h - Function C2h, Subfunction 03h 
POINTING DEVICE BIOS INTERFACE - SET RESOLUTION 


Purpose: Specifies the sensitivity level of the mouse or alternate pointing device. 


Available on: PS/2 models, Restrictions: none. 

Registers at call: Return Registers: 

AX =C203h CF set on error 

BH = resolution: AH = status (see above) 
00h one count per mm (25 dpi) CF clear if successful 


Oh two counts per mm (50 dpi) 

02h four counts per mm (100 dpi) 

03h eight counts per mm (200 dpi) 
Details: This function is called by the mouse driver if applicable; it need not be called by applications. 
Conflicts: None known, 


INTERRUPT 15h - Function C2h, Subfunction 04h 
POINTING DEVICE BIOS INTERFACE - GET TYPE 


Purpose: Determine type of pointing device present. 


Available on: PS/2 models. Restrictions: none, 
Registers at call: Return Registers: 
AX = C204h CF set on error 

AH = status: 


00h successful 

O1h invalid function 

02h invalid input 

03h interface error 

04h need to resend 

05h no device handler installed 

CF clear if successful 
BH = device ID 

Details: This function is called by the mouse driver if applicable; it need not be called by applications. 
Conflicts: None known. 


INTERRUPT 15h - Function C2h, Subfunction 05h 
POINTING DEVICE BIOS INTERFACE - INITIALIZE 


Purpose: Initializes BIOS interface to pointing device, 


Available on: PS/2 models. Restrictions: none. 
Registers at call: Return Registers: 

AX =C205h CF set on error 

BH = data package size (1 - 8 bytes) AH status (see above) 


CF clear if successful 
Details: This function is called by the mouse driver if applicable; it need not be called by applications. 
Conflicts: None known. 
See Also: Function C2h Subfunction 01h 
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INTERRUPT 15h - Function C2h, Subfunction 06h 
POINTING DEVICE BIOS INTERFACE - GET/SET SCALING FACTOR 


Purpose: Reads status of, or specifies scaling factor for, pointing device. 


Available on: PS/2 models. Restrictions: none. 
Registers at call: Return Registers: 
AX = C206h CF set on error 
BH = subfunction: AH = status: 
00h return device status 00h successful 
O1h set scaling at 1:1 Olh invalid function 
02h set scaling at 2:1 02h invalid input 


03h interface error 
04h need to resend 
05h no device handler installed 
CF clear if successful 
If subfunction 00h: 
BL & status: 
bit 0: right button pressed 
bit 1: reserved 
bit 2; left button pressed 
bit 3: reserved 
bit 4: 0 if I:1 scaling, 1 if 2:1 scaling 
bit 5: device enabled 
bit 6: 0 if stream mode, 1 if remote mode 
bit 7: reserved 
CL = resolution (see Function C2h Subfunction 
03h) 
DL = sample rate (reports per second) 
Details: This function is called by the mouse driver if applicable; it need not be called by applications. 
Conflicts: None known. 


INTERRUPT 15h - Function C2h, Subfunction 07h 
POINTING DEVICE BIOS INTERFACE - SET DEVICE HANDLER ADDRESS 


Purpose: Establishes address of pointing device handler routine. 





Available on: PS/2 models. Restrictions: none. 
Registers at call: Return Registers: 

AX = C207h CF set on error 

ES:BX = user device handler AH = status (see above) 


CF clear if successful 
Details: This function is called by the mouse driver if applicable; it need not be called by applications. 
Conflicts: None known. 
See Also: Mouse INT 33h Function 0Ch (chapter 13) 


INTERRUPT 15h - Function C3h 
SYSTEM - ENABLE/DISABLE WATCHDOG TIMEOUT 


Purpose: Enables or disables automatic watchdog timer. 


Available on: PS/2 model 50 and above. Restrictions: none. 

Registers at call: Return Registers: 

AH =C3h CF set on error 

AL = 00h disable CF clear if successful 
O1h enable 


BX = timer counter 
Details: The watchdog timer generates an NMI. 
Conflicts: None known. 
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INTERRUPT 15h - Function C4h 
SYSTEM - PROGRAMMABLE OPTION SELECT | 


Purpose: Modifies system's internal configuration registers. 


Available on: PS/2 model 50 and above. Restrictions: none. 
Registers at call: Return Registers: 
AH =C4h CF set on error 
AL = 00h return base POS register address DX = base POS register address (if function 00h) 
Oth enable slot 
BL = slot number 
02h enable adapter 


Details: This function can render a system inoperable and require total configuration via the reference diskette. It 
should be approached with extreme caution. 
Conflicts: None known. 


INTERRUPT 15h - Function C5h | 
Undocumented OS HOOK - ROM BIOS TRACING CALLOUT : 
Purpose: Allow a program to determine when and for which purpose various ROM BIOS interrupt handlers are 
invoked, 
Available on: PS/2 models 30/286, 50Z, and 95. Return Registers: 
Registers at call: all registers except AX must be preserved 
AH = CS5h 
AL = interrupt being invoked 
OLh INT 19h 
02h INT 14h 
03h INT 16h 
04h INT 40h (floppy INT 13h) 
05h INT {7h 
06h INT 10h 
07h INT 12h i 
08h INT 11h ' 
09h INT 1A { 
Details: This call is made as the very first action of the indicated ROM BIOS interrupt handlers on newer models of 
the PS/2 line. The default handler does nothing and returns CF clear for the above subfunctions, CF set and AH=86h 
for all other subfunctions. The value of AX passed to the original interrupt handler is pushed on stack immediately 
prior to call, where the handler may inspect it, if desired. 
Conflicts: None known. 


INTERRUPT 15h - Functions C6h through CFh 


Unknown Functions 

Purpose: The purpose of these functions had not yet been determined at the time of writing. 
Available on: PS/2 Model 95 Restrictions: unknown. 
Registers at call: Return Registers: unknown. 


AH = C6h through CFh 
other unknown. 
Conflicts: None known, 


INTERRUPT 16h - Function 00h 
KEYBOARD - GET KEYSTROKE 


Purpose: Waits for keyboard input. | 


Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AH = 00h AH = scan code 


AL = ASCII character 
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Details: On extended keyboards, this function discards all extended keystrokes, returning only when a non-extended 
keystroke is available. 

Conflicts: None known. 

See Also: Functions 01h, 05h, and 10h 


INTERRUPT 16h - Function 0th 
KEYBOARD - CHECK FOR KEYSTROKE 


Purpose: Checks for availablity of keyboard input. 


Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AH = 01h ZF set if no keystroke available 


ZF clear if keystroke available 

AH = scan code 

AL = ASCII character 
Details: If a keystroke is present, it is not removed from the keyboard buffer; however, any extended keystrokes 
which are not compatible with 83/84-key keyboards are removed in the process of checking whether a non-extended 
keystroke is available. 
Conflicts: None known. 
See Also: Functions 00h and 1 ih 


INTERRUPT 16h - Function 02h 
KEYBOARD - GET SHIFT FLAGS 


Purpose: Returns shift-flags byte maintained by BIOS. 


Available on; All machines, Restrictions: none, 
Registers at call: Return Registers: 
AH =02h AL = shift flags: 


bit 7: Insert active 
6: CapsLock active 
5: NumLock active 
4: ScrollLock active 
3: Alt key pressed (either Alt on 101/102-key 
keyboards) 
2: Ctrl key pressed (either Ctrl on 101/102-key 
keyboards) 
1: left shift key pressed 
0: right shift key pressed 
Conflicts: None known. 
See Also: Function 12h 


INTERRUPT 16h - Function 03h 
KEYBOARD - SET TYPEMATIC RATE AND DELAY 


Purpose: Adjust repeat rate of keyboard. 


Available on: PCjr, PC-AT, PS/2. Restrictions: PCjr functions are totally unlike those 
for other systems, 

Registers at call: Return Registers: n/a 

AH = 03h 


AL = subfunction: 
00h (PCjr) set default delay and rate 
Olh (PCjr) increase delay before repeat 
02h (PCjr) decrease repeat rate by factor 
of 2 
03h (PCjr) increase delay and decrease 
repeat rate 
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04h (PCjr) turn off typematic repeat 
O5h (AT, PS/2) set repeat rate and delay 
BH = delay value 
(00h = 250ms to 03h = 1000ms) 
BL = repeat rate 
(00h=30/sec to OCh=10/sec 
[default] to 1Fh=2/sec) 
Conflicts: None known. 


INTERRUPT 16h - Function 04h 
KEYBOARD - SET KEYCLICK 


Purpose: Enables or disables keyclick sound action. 
Available on: PCjr only. Restrictions: none. 
Registers at call: Return Registers: n/a 
AH = 04h 
AL = keyclick state: 
00h off 
Olh on 
Conflicts: None known. 
See Also: Function 03h 


INTERRUPT 16h - Function 05h 
KEYBOARD - STORE KEYSTROKE IN KEYBOARD BUFFER 


Purpose: Emulates entry of keystroke under program control. 


Available on: AT or PS/2 with enhanced keyboard Restrictions: none. 
support only. 
Registers at call: Return Registers: 
AH = 05h AL = 00h if successful 
CH = scan code Olh if keyboard buffer full 


CL = ASCII character 
Details: Under DESQview, the following "keystrokes" invoke the indicated actions when they are read from the 


keyboard buffer: 


38FCh pops up DESQview main menu. 
38FEh closes current window. 
38FFh pops up DESQview Learn menu. 


Conflicts: None known. 
See Also: Function 00h, FAKEY.COM Function 71h (chapter 36), DESQview INT [5h Function DEh Subfunction 
10h (chapter 15) 


INTERRUPT 16h - Function 10h 
KEYBOARD - GET ENHANCED KEYSTROKE 


Purpose: Wait for any keyboard input. 


Available on: AT or PS/2 with enhanced keyboard Restrictions: none. 
support only, 

Registers at call: Return Registers: 

AH = 10h AH = scan code 


AL = ASCII character 
Details: If no keystroke is available, this function waits until one is placed in the keyboard buffer. Unlike Function 
00h, this function does not discard extended keystrokes. 
Conflicts: None known. 
See Also: Functions 00h and 11h 
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INTERRUPT 16h - Function 11h 
KEYBOARD - CHECK FOR ENHANCED KEYSTROKE 


Purpose: Checks for availablity of any keyboard input, 


Available on: AT or PS/2 with enhanced keyboard Restrictions: none. 
only, 
Registers at call: Return Registers: 
AH=11h ZF set if no keystroke available 


ZF clear if keystroke available 
AH = scan code 
AL = ASCII character 
Details: If a keystroke is available, it is not removed from the keyboard buffer. Unlike Function 01h, this function 
does not discard extended keystrokes, 
Conflicts: None known, 
See Also: Functions 01h and 10h 


INTERRUPT 16h - Function 12h 
KEYBOARD - GET EXTENDED SHIFT STATES 


Purpose: Returns all shift-flags information from enhanced keyboards. 


Available on: AT or PS/2 with enhanced keyboard Restrictions: none. 
only. 
Registers at call: Return Registers: 
AH = 12h AL = shift flags 1 (same as returned by Function 02h): 


bit 7: Insert active 
6: CapsLock active 
5: NumLock active 
4: ScrollLock active 
3: Alt key pressed (either Alt on 101/102-key 
keyboards) 
2: Ctrl key pressed (either Ctrl on 101/102-key 
keyboards) 
1; left shift key pressed 
0; right shift key pressed 
AH = shift flags 2: 
bit 7: SysRq key pressed 
6: CapsLock pressed 
5: NumLock pressed 
4: ScrollLock pressed 
3: right Alt key pressed 
2: right Ctrl key pressed 
1; left Alt key pressed 
0: left Ctrl key pressed 
Details: AL bit 3 is set only for left Alt key on many machines. AH bits 7 through 4 are always clear on a Compaq 
SLT/286. 
Conflicts: None known. 
See Also: Function 02h 


INTERRUPT 17h - Function 00h 


PRINTER - WRITE CHARACTER 


Purpose: Outputs one byte to printer. 
Available on: All machines. Restrictions: none. 


i 
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Registers at call: Return Registers: 
AH =00h AH = printer status: 
AL = character to write bit 7: not busy 
DX = printer number (00h-02h) 6: acknowledge 

5: out of paper 

4: selected 

3: Y/O error 

2: unused 

1; unused 

0: timeout 
Conflicts: None known. 
INTERRUPT 17h - Function 01h 
PRINTER - INITIALIZE PORT 
Purpose: Resets printer port. 
Available on: All machines, Restrictions: none. 
Registers at call: Return Registers: 
AH =01h AH = printer status (see above) 
DX = printer number (00h-02h) 
Conflicts: None known. 
See Also: Function 02h 
INTERRUPT 17h - Function 02h 
PRINTER - GET STATUS 
Purpose: Obtains status of printer. 
Available on: All machines. Restrictions: none, 
Registers at call: Return Registers: 
AH =02h AH = printer status: (see above) 
DX = printer number (00h-02h) 
Conflicts: INSET (chapter 36), 
See Also: Function 01h 
INTERRUPT 18h 
START CASSETTE BASIC 
Purpose: Invoke ROM-based BASIC interpreter. 
Available on: Genuine IBM machines only. Restrictions: See "Details" below. 
Registers at call: n/a Return Registers: n/a 


Details: Only PCs produced by IBM contain BASIC in ROM, so the action is unpredicatable on compatibles; this 
interrupt often reboots the system, and often has no effect at all. 
Conflicts: None known. 


INTERRUPT 19h 
SYSTEM - BOOTSTRAP LOADER 


Purpose: Reboots system without clearing memory or restoring interrupt vectors. 


Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
To accomplish a warm boot equivalent to Ctrl-Alt- never returns 


Del, store 1234h in 0040h:0072h and jump to 

FFFFh:0000h. For a cold boot equivalent to a reset, 

store 0000h at 0040h:0072h before jumping. 

Details: Because interrupt vectors are preserved, this interrupt usually causes a system hang if any TSRs have 
hooked vectors from 00h through 1Ch, particularly INT 08h. 
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Usually, the BIOS will try to read sector 1, head 0, track 0 from drive A: to 0000h:7COOh. If this fails, and a hard 
disk is installed, the BIOS will read sector 1, head 0, tack 0 of the first hard disk. This sector should contain a 
master bootstrap loader and a partition table. 

After loading the master boot sector at 0000h:7CO00h, the master bootstrap loader is given control. It will scan the 
partition table for an active partition, and will then load the operating system's bootstrap loader (contained in the first 
sector of the active partition) and give it control. True IBM PCs issue an INT 18h if neither floppy nor hard disk have 
a valid boot sector. 

VDISK.SYS hooks this interrupt to allow applications to find out how much extended memory has been used by 
VDISKs (the three bytes at offset 2Ch in the INT 19h handler’s segment contain the linear address of the first free 
extended memory). 

The default handler is at FOOOh:E6F2h for 100% compatible BIOSes. 

Conflicts: None known. 
See Also: INT 18h, FOSSIL INT 14h Function 17h (chapter 17) 


Table 3-7. Format of hard disk master boot sector: 


Offset Size Description 

00h 446 BYTEs Master bootstrap loader code 

1BEh 16 BYTEs partition record for partition 1 (see below) 
1CEh 16 BYTEs partition record for partition 2 

1DEh 16 BYTEs partition record for partition 3 

1EEh 16 BYTEs partition record for partition 4 

1FEh WORD signature, AA55h indicates valid boot block 


Table 3-8. Format of partition record: 


Offset Size Description 

00h BYTE boot indicator (80h = active partition) 

Olh BYTE partition start head 

02h BYTE partition start sector (bits 0-5) 

03h BYTE partition start track (bits 8,9 in bits 6,7 of sector) 
04h BYTE operating system indicator (see below) 

05h BYTE partition end head 

06h BYTE partition end sector (bits 0-5) 

O7h BYTE partition end track (bits 8,9 in bits 6,7 of sector) 
08h DWORD _ sectors preceding partition 

0Ch DWORD length of partition in sectors 


Table 3-9. Values for operating system indicator: 


Value System 

00h empty 

Olh DOS 12-bit FAT 

02h XENIX file system 

03h XENIX /usr file system (obsolete) 
04h DOS 16-bit FAT 

05h DOS 3.3+ extended partition 
06h DOS Large File System 

07h QNX, OS/2 HPFS 

08h AIX bootable partition 

09h AIX data partition 

Sih Disk Manager 

52h CP/M 

56h GB 

6th SpeedStor 

63h SysV/386 


64h Novell NetWare 
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Table 3-9. Values for operating system indicator (continued) 


Value System 

75h PC/IX 

80h Minix v1.3 and below 

81h Minix v1.5+ 

DBh CP/M 

Elh SpeedStor 12-bit FAT extended partition 
E4h SpeedStor 16-bit FAT extended partition 
FEh LANstep 

FFh bad blocks 

INTERRUPT 1Ah - Function 00h 

TIME - GET SYSTEM TIME 


Purpose: Reads BIOS real-time clock maintained in RAM. 
Available on: All machines. 


Registers at call: 
AH = 00h 
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Restrictions: Destroys midnight flag without adjusting 
DOS calendar; this can cause system 
calendar to lose a day. 

Return Registers: 

CX:DX = number of clock ticks since midnight 

AL = midnight flag, nonzero if midnight passed since 

time last read 


Details: There are approximately 18.2 clock ticks per second, 1800BOh per 24 hrs. IBM and many clone BIOSes set 
the flag for AL rather than incrementing it, leading to loss of a day if two consecutive midnights pass without a 


request for the time (e.g. if the system is on but idle). 
Conflicts: None known. 


See Also: Functions 01h and 02h, DOS INT 21h Function 2Ch (chapter 8) 


INTERRUPT 1Ah - Function 01h 
TIME - SET SYSTEM TIME 


Purpose: Sets BIOS real-time clock maintained in RAM. 
Available on: All machines. 

Registers at call: 

AH = 01h 

CX:DX = number of clock ticks since midnight 

Conflicts: None known. 

See Also: Functions 00h and, DOS INT 21h Function 2Dh 


INTERRUPT 1Ah - Function 02h 
TIME - GET REAL-TIME CLOCK TIME 
Purpose: Reads CMOS clock data, 
Available on: PC-AT, XT286, PS/2. 
Registers at call: 

AH = 02h 


Conflicts: None known. 
See Also: Function 00h 


Restrictions: none. 
Return Registers: n/a 


Restrictions: none. 
Return Registers: 
CF clear if successful 
CH = hour (BCD) 
CL = minutes (BCD) 
DH = seconds (BCD) 
DL = daylight savings flag (00h standard time, 
Oh daylight time) 
CF set on error (i.e. clock not running or in middle of 
update) 
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INTERRUPT 1Ah - Function 03h 
TIME - SET REAL-TIME CLOCK TIME 


Purpose: Sets CMOS clock. 


Available on: PC-AT, XT286, PS/2. Restrictions: none. 
Registers at call: Return Registers: n/a 
AH = 03h 


CH = hour (BCD) 

CL = minutes (BCD) 

DH = seconds (BCD) 

DL = daylight savings flag (00h standard time, 
Oth daylight time) 

Conflicts: None known. 

See Also: Function Oth 


INTERRUPT 14h - Function 04h 
TIME - GET REAL-TIME CLOCK DATE 


Purpose: Read date from CMOS calendar. 


Available on: PC-AT, XT286, PS/2. Restrictions: none. 
Registers at call: Return Registers: 
AH = 04h CF clear if successful 


CH = century (BCD) 
CL = year (BCD) 
DH = month (BCD) 
DL = day (BCD) 
CF set on error 
Conflicts: None known. 
See Also: Functions 02h and 05h, DOS INT 21h Function 2Ah (chapter 8) 


INTERRUPT 1Ah - Function 05h 
TIME - SET REAL-TIME CLOCK DATE 


Purpose: Sets CMOS calendar. 


Available on: PC-AT, XT286, PS/2. Restrictions: none. 
Registers at call: Return Registers: n/a 
AH = 05h 


CH = century (BCD) 

CL = year (BCD) 

DH = month (BCD) 

DL = day (BCD) 

Conflicts: None known. 

See Also: Function 04h, DOS INT 21h Function 2Bh (chapter 8) 


INTERRUPT 1Ah - Function 06h 
TIME - SET ALARM 


Purpose: Sets alarm time in CMOS, 


Available on: PC-AT, XT286, PS/2. Restrictions: none. 

Registers at call: Return Registers: 

AH = 06h CF set on error (alarm already set or clock stopped for 
CH = hour (BCD) update) 

CL = minutes (BCD) CF clear if successful 


DH = seconds (BCD) 

Details: The alarm occurs every 24 hours until turned off, invoking INT 4Ah each time. 
Conflicts: None known. 

See Also: Function 07h, INT 4Ah 


i 
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INTERRUPT 1Ah - Function 07h 
TIME - CANCEL ALARM 


Purpose: Disables CMOS alarm. 


Available on: PC-AT, XT286, PS/2. Restrictions: none. 
Registers at call: Return Registers: none. 
AH = 07h 


Details: Does not disable the real-time clock’s IRQ 
Conflicts: None known, 
See Also: Function 06h, IRQ8 on INT 70h (chapter 2) 


INTERRUPT 1Ah - Function 08h 
TIME - SET RTC ACTIVATED POWER ON MODE 


Purpose: Specify the time at which power will automatically be turned on. 


Available on: Convertible only. Restrictions: none. 
Registers at call: Return Registers: n/a 
AH = 08h 


CH = hours in BCD 

CL = minutes in BCD 
DH = seconds in BCD 
Conflicts: None known. 
See Also: Function 09h 


INTERRUPT 1Ah - Function 09h 
TIME - READ RTC ALARM TIME AND STATUS 


Purpose: Determine the status and time setting of the real-time-clock alarm. 
Available on: Convertible, PS/2 model 30. Restrictions: none. 
Registers at call: 
AH = 09h 
Return Registers: 
CH = hours in BCD 
CL = minutes in BCD 
DH = seconds in BCD 
DL = alarm status 
00h alarm not enabled 
Oth alarm enabled but will not power up system 
02h alarm will power up system 
Conflicts: None known. 
See Also: Function 08h 


INTERRUPT 1Ah - Function 0Ah 
TIME - READ SYSTEM-TIMER DAY COUNTER 


Purpose: To determine setting of DOS calendar. 


Available on: XT2, PS/2 models, Restrictions: none. 
Registers at call: Return Registers: 
AH=0Ah CF set on error 


CF clear if successful 
CX = count of days since Jan. 1, 1980. 
Conflicts: None known. 
See Also: Functions 04h and OBh 
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INTERRUPT 1Ah - Function 0Bh 
TIME - SET SYSTEM-TIMER DAY COUNTER 


Purpose: To set DOS calendar. 


Available on: XT2, PS/2 models. Restrictions: none. 
Registers at call: Return Registers: 
AH =O0Bh CF set on error 

CX = count of days since Jan 1, 1980 CF clear if successful 


Conflicts: None known. 
See Also: Functions 05h and OAh 


INTERRUPT 14h - Function 80h 
PCjr - SET UP SOUND MULTIPLEXOR 


Purpose: Controls sound multiplexor circuits. 
Available on: PCjr only. Restrictions: none. 
Registers at call; AH = 80h Return Registers: n/a 
AL = 00h source is 8253 channel 2 

Olh source is cassette input 

02h source is I/O channel "Audio IN” 

03h source is sound generator chip 
Conflicts: None known. 


INTERRUPT 1Bh 
KEYBOARD - CONTROL-BREAK HANDLER 


Purpose: Called when INT 09h determines that Control-Break has been pressed. 

Available on: All machines, Restrictions: none. 

Registers at call: n/a Return Registers: n/a 

Details: Normally points to a short routine in DOS which sets the Ctrl-C flag, thus invoking INT 23h the next time 
DOS checks for Ctrl-C. 

Conflicts; None known. 

See Also: INT 23h 


INTERRUPT 1Ch 

TIME - SYSTEM TIMER TICK 

Purpose: Called on each clock tick by the INT 08h handler. 

Available on: All machines. Restrictions: none. 
Registers at call: n/a Return Registers: n/a 


Details: This is the preferred interrupt to chain when a program needs to be invoked regularly. 
Conflicts: None known. 
See Also: INT 08h (chapter 2) 


INTERRUPT 48h 
KEYBOARD - CORDLESS KEYBOARD TRANSLATION 


Purpose: Initiates data translation from cordless keyboard. 

Available on: PCjr only. Restrictions: none, 
Registers at call: n/a Return Registers: n/a 
Conflicts: None known. 

See Also: INT 49h 


INTERRUPT 49h 
SYSTEM DATA - NON-KEYBOARD SCAN-CODE TRANSLATION TABLE 


Purpose: Not an interrupt; this vector is a far pointer to the translation table described in Table 3-10. 
Available on: PCjr only. Restrictions: none. 
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Registers at call: n/a Return Registers: n/a 
Conflicts: None known. 
See Also: INT 48h 


Table 3-10. Format of transiation table 


Offset Size Description 
00h BYTE number of non-keyboard scancodes in the table 
Oth N WORDs high byte 00h (NUL) byte scancode with low order byte representing the scancode mapped 


values relative to their input values within the range of 56h through 7Eh. 


INTERRUPT 4Ah 
SYSTEM - USER ALARM HANDLER 


Purpose: Hook to user-supplied alarm function. 


Available on: Systems which provide RTC alarm Restrictions: none. 
capability (PC-AT, XT2, 
Convertible, PS/2) 

Registers at call: n/a Return Registers: n/a 


Details: This interrupt is invoked by the BIOS when a real-time clock alarm occurs. An application may use it to 
perform an action at a predetermined time; however, this interrupt is called from within a hardware interrupt handler, 
so all usual precautions against reentering DOS must be taken. 

Conflicts: None known, 

See Also: INT 1Ah Function 06h, DOS 3,2 INT 6Ch (chapter 8) 

System Resume Vector 

Purpose: Provides hook that is called when system automatically resumes operation in response to an RTC alarm. 
Available on: Convertible only. Restrictions: none. 

Registers at call: n/a Return Registers: n/a 

Conflicts: DOS 3.2 Realtime Clock update (chapter 8). 

MSee Also: INT 4Ah 





Chapter @ 4 


Vendor-Specific ROM BIOS Extensions 


This chapter describes ROM BIOS extensions that are unique to a single non-IBM vendor. The information is organ- 
ized in alphabetic sequence by vendor name, and within each vendor’s section, in numeric sequence by INT number, 


function, and subfunction. 
Amstrad 


INTERRUPT 15h - Function 00h 
Amstrad PC1512 - GET AND RESET MOUSE COUNTS 


Purpose: Reads mouse position and resets motion counters. 








Available on: Amstrad PC1512 only. Restrictions: none, 
Registers at call: Return Registers: 
AH = 00h CX = signed X count 


DX = signed Y count 
Conflicts: Cassette (chapter 3), MultiDOS Plus (chapter 16), VMiX (chapter 17). 


INTERRUPT 15h - Function 01h 


Amstrad PC1512- WRITE DATA TO NON-VOLATILE RAM 
Purpose: Writes one byte to CMOS RAM. 


Available on: Amstrad PC1512 only. Restrictions: none. 
Registers at call: Return Registers: 
AH =01h AH = return code 
AL=NVRAM location (00h to 3Fh) 00h OK 

BL = NVRAM data value O1h address bad 


02h write error 


Conflicts: None known. 
See Also: Function 02h 


Table 4-1. Format of Non-Volatile RAM 


Offset Size Description 

00h BYTE time of day: seconds 
Oth BYTE alarm time: seconds 
02h BYTE time of day: minutes 
03h BYTE alarm time: minutes 
04h BYTE time of day: hours 
05h BYTE alarm time: hours 
06h BYTE day of week, 1 = Sunday 
07h BYTE day of month 

08h BYTE month 

09h BYTE year mod 100 

OAh BYTE RTC status register A: 


bit 7: set if date/time being updated 
6-4: time base speed, default 010 = 32768 Hz 
3-0: interrupt rate selection, default 0110 = 1024 Hz 
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Table 4-1. Format of Non-Volatile RAM (continued) 


Offset Size Description 
OBh BYTE RTC status register B: 
bit 7: clear if normal update, set if abort update 
6: periodic interrupt enable 
5; alarm interrupt enable 
4: update end interrupt enable 
3: square wave enable 
2: date mode (clear = BCD, set = binary) 
1; 24-hour format 
0: daylight saving time enable 











0Ch BYTE RTC status register C (read-only): 
bit 7: IROF flag 

6: PF flag 

5: AF flag 

4: UF flag 
ODh BYTE RTC status register D: 

bit 7: battery good 

OE! 6BYTEs time and date machine was last used 
14h BYTE user RAM checksum 
15h WORD Enter key scancode/ASCII code 
17 WORD Forward delete key scancode/ASCII code 
19) WORD Joystick fire button 1 scancode/ASCII code 
1B WORD Joystick fire button 2 scancode/ASCII code 
1Dh WORD mouse button 1 scancode/ASCII code 
1Fh WORD mouse button 2 scancode/ASCII code 
21 BYTE mouse X scaling factor 
22h BYTE mouse Y scaling factor 
23 BYTE initial VDU mode and drive count 
24 BYTE initial VDU character attribute 
25 BYTE size of RAM disk in 2K blocks 
26 BYTE initial system UART setup byte 
27h BYTE initial external UART setup byte 
28h 24 BYTEs available for user application 


Details: Bytes 00h-ODh are the same on the IBM AT since they are used/updated by the clock chip. 


Conflicts: Cassette (chapter 3), MultiDOS Plus (chapter 16), VMiX (chapter 17). 


INTERRUPT 15h - Function 02h 
Amstrad PC1512 » READ DATA FROM NON-VOLATILE RAM 


Purpose: To read data from NVRAM. 


Available on: Amstrad PC1512 only. Restrictions: none. 
Registers at call: Return Registers: 
AH =02h AH = return code: 
AL = NVRAM location (00h to 3Fh) 00h OK 

(see Table 4-1) Oh address bad 


02h checksum error 
AL = NVRAM data value 
Conflicts: Cassette (chapter 3), MultiDOS Plus (chapter 16), VMiX (chapter 17). 
See Also: Function 01h 


INTERRUPT 15h - Function 03h 
Amstrad PC1512 - WRITE VDU COLOR PLANE WRITE REGISTER 


Purpose: Sets video display unit plane(s) to be written. 
Available on: Amstrad PC1512 only. Restrictions: none. 
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Registers at call: Return Registers: unknown. 
AH = 03h 

AL = value (LR,G,B bits) 

Conflicts: Cassette (chapter 3), MultiDOS Plus (chapter 16), VMixX (chapter 17). 

See Also: Function 04h 


INTERRUPT 15h - Function 04h 
Amstrad PC1512 - WRITE VDU COLOR PLANE READ REGISTER 


Purpose: Sets video display unit plane(s) to be read. 


Available on: Amstrad PC1512 only. Restrictions: none. 
Registers at call: Return Registers: unknown. 
AH = 04h 


AL = value (RDSEL1 and RDSELO) 
Conflicts: Build ABIOS System Parameter Table (chapter 3), MultiDOS Plus (chapter 16), VMixX (chapter 17). 


See Also: Functions 03h and 05h 


INTERRUPT 15h - Function 05h 
Amstrad PC1512 - WRITE VDU GRAPHICS BORDER REGISTER 


Purpose: Establishes border color for video display unit. 


Available on: Amstrad PC1512 only. Restrictions: none. 
Registers at call: Return Registers: unknown. 
AH = 05h 


AL = value (1,R,G,B bits) 
Conflicts: Build ABIOS Initialisation Table (chapter 3), MultiDOS Plus (chapter 16), VMiX (chapter 17). 
See Also: Function 04h 


INTERRUPT 15h - Function 06h 
Amstrad PC1512 - GET ROS VERSION NUMBER 


Purpose: Determine ROM version number. 


Available on: Amstrad PC1512 only, Restrictions: none, 
Registers at call: Return Registers: 
AH = 06h BX = version number 
Conflicts: MuitiDOS Plus (chapter 16), VMiX (chapter 17). 

AT&T 6300 


INTERRUPT 1Ah - Function FEh 
AT&T 6300 READ TIME AND DATE 


Purpose: Read both time and date for the system. Note that the day count starts four years later than the industry 
standard date. 


Available on: AT&T 6300 systems only. Restrictions: none. 

Registers at call: Return Registers: 

AH = FEh BX = day count (0 = Jan 1, 1984) 
CH = hour 
CL = minute 


DL = hundredths 


Conflicts: None known. 
See Also: Function FFh, DOS INT 21h Functions 2Ah and 2Ch (chapter 8) 


INTERRUPT 1Ah - Function FFh 
AT&T 6300 - SET TIME AND DATE 


Purpose: Set both time and date for the system. Note that the day count starts four years later than the industry 
standard date. 


4-4 Vendor-Specific ROM BIOS Extensions 


Available on: AT&T 6300 systems only. Restrictions: none. 
Registers at call: Return Registers: unknown. 
AH = FFh 

BX = day count (0 = Jan 1, 1984) 

CH = hour 

CL = minute 

DH = second 

DL = hundredths 

Conflicts: None known, 

See Also: Function FEh, DOS INT 21h Functions 2Bh and 2Dh (chapter 8) 


Atari Portfolio 
The Portfolio is a "palmtop" computer. 


INTERRUPT 60h 
USER INTERFACE FUNCTIONS 


Purpose: Provide functions for interacting with the user. 

Available on: Atari Portfolio only. Restrictions: none. 

Details: This interrupt supplies a number of subfunctions which perform such functions as drawing boxes and 
menus, and provide input line editing. 

Conflicts: see Table 1-3 in chapter 1. 

See Also: INT 61h 


INTERRUPT 61h 

EXTENDED BIOS 

Purpose: Access extended functions for controlling the system. 

Available on: Atari Portfolio only. Restrictions: none. 


Details: This interrupt provides subfunctions such as turning off the machine, accessing internal variables, and 
mapping memory cards. 

Conflicts: see Table 1-3 in chapter 1. 

See Also: INT 60h 


Compaq 


INTERRUPT 15h - Function 40h, Subfunction 00h 
Compaq SLT/286 or Portable 386 - READ LCD/PLASMA TIMEOUT 


Purpose: Gets timeout value for display in minutes. 


Available on: Compaq SLT/286 or Portable 386. Restrictions: none. 
Registers at call: Return Registers: 
AX = 4000h AX = 4000h 


CL = 00h timeout disabled 
else timeout in minutes 
Conflicts: PC Convertible (chapter 3). 
See Also: Function 40h Subfunction 01h, Function 46h Subfunction 00h. 


INTERRUPT 15h - Function 40h, Subfunction 01h 
Compaq SLT/286 or Portable 386 - SET LCD/PLASMA TIMEOUT 


Purpose: Sets timeout value for display in minutes. 
Available on: Compaq SLT/286 or Portable 386. Restrictions: none. 
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Registers at call: Return Registers: i 
AX = 400ih AL = 00h timeout modified H 
CL = 00h timeout disabled O1h timeout cannot be modified : 


40h timeout cannot be modified 
CL = 00h timeout disabled 
else timeout in minutes 


else timeout in minutes 


Conflicts: PC Convertible (chapter 3). | 
See Also: Function 40h Subfunction 00h, Function 46h Subfunction 01h 


INTERRUPT 15h - Function 42h, Subfunction 80h 
Compag SLT/266 - ENTER STANDBY MODE 


Purpose: Places system in power conservation (standby) mode. 





Available on: Compaq SLT/286 only. Restrictions: none. 
Registers at call: Return Registers: 
AX = 4280h AH = 42h 


i CF clear if successful 
CF set if unable to enter standby 


Conflicts: PC Convertible (chapter 3). 
See Also: Function 46h Subfunction 00h 


INTERRUPT 15h - Function 46h, Subfunction 00h 
Compaq SLT/286 ~ READ POWER CONSERVATION/MODEM CONFIGURATION 


Purpose: Determine current power conservation and modem configurations. | 
Available on: Compaq SLT/286 only. Restrictions: none. i 


Registers at call: Return Registers: 
AX = 4600h AH = modem configuration information: 


bit 0 powerup state | 
0 off i 
lon 
1 modem installed 
2 IRQ line assignment 
OIRQ4 
| 1IRQ3 
3 COM port assignment 
| 0=COM 2 


1=COM1 
4 modem state 
0 not assigned 
L assigned 
5 modem is on 
AL = power conservation status information: 
bit 0 power source (0 internal, 1 external) 
1-2 low battery state 
00 no low battery condition 
01 low battery 1 
10 reserved 
11 low battery 2 
3-4 power conservation mode 
00 automatic 
Ol on 
10 off 
11 reserved 
BH = default system inactivity timeout (1-21 minutes) 


| 
| 
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Conflicts: None known. 


BL = current system inactivity timeout (1-21 minutes) 
CH = default video display inactivity timeout 
(1-63 minutes) 
CL = current video display inactivity timeout 
(1-63 minutes) 
DH = default fixed disk drive inactivity timeout 
(1-21 minutes) 
DL = current fixed disk drive inactivity timeout 
(1-21 minutes) 


See Also: Function 42h Subfunction 80h, Function 46h Subfunction 01h, Compaq INT 77h (chapter 2) 


INTERRUPT 15h - Function 46h, Subfunction 01h 


Compaq SLT/286 - MODIFY POWER CONSERVATION/MODEM CONFIGURATION 


Purpose: Set current power conservation and modem configurations. 


Available on: Compag SLT/286. 
Registers at call: 


Restrictions: none. 
Return Registers: 


AX = 4601h CF clear if successful 
BL = system inactivity timeout (1-21 minutes) AH =00h 
FFh do not change BL = current system inactivity timeout 
CL = video display inactivity timeout (1-63 (1-21 minutes) 
minutes) CL = current video display inactivity timeout 
FFh do not change (1-63 minutes) 


DL = current fixed disk drive inactivity timeout 
(1-21 minutes) 
FFh do not change 
DH = 00h turn modem OFF 
Olh turn modem ON 
FFh do not change modem state 


DL = current fixed disk drive inactivity timeout 
(1-21 minutes) 
DH = FFh modem state unchanged 
= 00h modem turned OFF 
= O1h modem turned ON 
CF set on error 
AH = 01h input is out of range 
= 02h - No modem present 
Conflicts: None known. 
See Also: Function 46h Subfunction 00h, Compaq INT 77h (chapter 2) 


INTERRUPT 15h - Function E0h, Subfunction OFh 
Compaq Systempro - MULTIPROCESSOR DISPATCH 


Purpose: Initiate a process on the other processor of a dual-processor system. 
Available on: Compaq Systempro only. Restrictions: none. 
Registers at call: Return Registers: 
AX = EQOFh AL = OFh successful 
ES:BX -> start of 2nd processor's execution 00h failure 
Conflicts: None known. 
See Also: Function El 


INTERRUPT 15h - Function E1h, Subfunction 0Eh 
Compaq Systempro » MULTIPROCESSOR END-OF-DISPATCH 


Purpose: Terminate the current activity on the other processor of a dual-processor system. 
Available on: Compaq Systempro only. Restrictions: none. 
Registers at call: Return Registers: 

AX =EI0Eh AL = OFh successful (halted) 
ES:BX -> start of 2nd processor's execution 00h failure (not halted) 
Conflicts: None known. 

See Also: Function EOh Subfunction OFh, Function E2h Subfunction 00h 


Subfunction OEh, Function E2h Subfunction 00h 
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INTERRUPT 15h - Function E2h, Subfunction 00h 
Compaq Systempro - MULTIPROCESSOR AVAILABLE 


Purpose: Determine whether the other processor of a dual-processor system is available for dispatching. 


Available on: Compaq Systempro only. Restrictions: none, 
Registers at call: Return Registers: 
AX = E200h AX = 8000h if 2nd processor available 


Conflicts: None known. 
See Also: Function EO0h Subfunction OFh, Function Elh Subfunction OEh 


INTERRUPT 16h - Function FOh 
Compaq 386 - SET CPU SPEED 
Purpose: Set CPU speed for the system. 
Available on: Compaq 386 models only. Restrictions: none. 
Registers at call: Return Registers: unknown. 
AH = FOh 
AL = speed: 
00h equivalent to 6 MHz 80286 (COMMON) 
Oth equivalent to 8 MHz 80286 (FAST) 
02h full 16 MHz (HIGH) 
03h toggles between 8 MHz-equivalent and 
speed set by system-board switch (AUTO or 
HIGH) 
O8h full 16 MHz except 8 MHz-equivalent 
during floppy-disk access 
09h specify speed directly 
CX = speed value, | (slowest) to 50 (full), 
3 is approximately 8088 speed 
Conflicts: TurboPower TSRs Installation Check (chapter 36). 
See Also: Functions Flh and F3h 


INTERRUPT 16h - Function Fih 
Compaq 386 - READ CURRENT CPU SPEED 


Purpose: Obtain current speed setting. 


Available on: Compaq 386 models only. Restrictions: none. 
Registers at call: Return Registers: 
AH = Flh AL = speed code (see Function F0h) 


CX = speed code if AL = 09h 
Conflicts: None known. 
See Also: Functions F0h and F3h 


INTERRUPT 16h - Function F2h 
Compaq 386 - DETERMINE ATTACHED KEYBOARD TYPE 


Purpose: Determine whether the keyboard is PC or AT type. 


Available on: Compaq 386 models only. Restrictions: none. 
Registers at call: Return Registers: 
AH = F2h AL = type: 


00h if 11-bit AT keyboard is in use 
OLh if 9-bit PC keyboard is in use 
Conflicts: None known. 
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INTERRUPT 16h - Function F3h 


Compaq 80286s - SET CPU SPEED LIMIT (OVERRIDE JUMPER) 


Purpose: Establish limit on CPU speed. 
Available on: Compaq 80286 models only. 
Registers at call: 
AH =F3h 
AL = 00h limit is 6 Mhz 
Olh limit is 8 Mhz/6 Mhz 
Conflicts: None known. 
See Also: Functions FOh and Flh 


INTERRUPT 16h - Function F4h, Subfunction 00h 
Compaq Systempro - CACHE CONTROLLER STATUS 


Purpose: Determine whether memory is being cached. 
Available on: Compaq Systempro only. 

Registers at call: 

AX = F400h 


Conflicts: None known. 
See Also: Function F4h Subfunctions 01h and 02h 
Compaq Systempro - ENABLE CACHE CONTROLLER 


INTERRUPT 16h - Function F4h, Subfunction 01h 
Purpose: Enable memory cache controller. 

Available on: Compaq Systempro only. 

Registers at call; 

AX = F401h 

Conflicts: None known, 

See Also: Function F4h Subfunctions 00h and 02h 


INTERRUPT 16h - Function F4h, Subfunction 02h 
Compaq Systempro - DISABLE CA CHE CONTROLLER 


Purpose: Disable memory cache controller. 
Available on: Compaq Systempro only. 
Registers at call: 

AX = F402h 

Conflicts: None known. 

See Also: Function F4h Subfunctions 00h and OLh 


EISA System ROM 
INTERRUPT 15h - Function D8h, Subfunction 00h 


Restrictions: none. 
Return Registers: unknown. 


Restrictions: none. 
Return Registers: 
AH=E2h 
AL = status 
00h no cache controller 
Olh enabled 
02h disabled 


Restrictions: none. 
Return Registers: 
AX = E201h 


Restrictions: none. 
Return Registers: 
AX = E202h 


EISA SYSTEM ROM - READ SLOT CONFIGURATION INFORMATION 


Purpose: Determine slot configuration. 
Available on: EISA systems. 


Restrictions: none. 





| 
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Registers at call: Return Registers: 
AX = D800h CF clear if successful 
CL = slot number (including embedded and virtual) AH = 00h 


CF set on error 
AH = error code 
80h invalid slot number 
82h EISA CMOS corrupt 
83h empty slot 


86h invalid BIOS-FW function call 
87h invalid system configuration 
AL bit flags 
bit 7: set if duplicate IDs 
6: set if product ID readable 
4,5: slot type (00=expansion, 01=embedded, 
10=virtual device) 
0-3: duplicate ID number if bit 7 set 
BH = major revision level of configuration utility 
BL = minor revision level of configuration utility 
CX = checksum of configuration file 
DH = number of device functions 
DL = combined function information byte 
SI:DI = 4-byte compressed ID (DI = bytes 0&1, 
SI = bytes 2&3) 
Details: Call with AL=80h if using 32-bit CS addressing mode instead of 16-bit. 
Conflicts: None known. 
See Also: Function D8h Subfunctions 01h and 04h 


INTERRUPT 15h - Function D8h, Subfunction 01h 
EISA SYSTEM ROM - READ FUNCTION CONFIGURATION INFORMATION 


Purpose: Determine function configuration. 





Available on: EISA systems. Restrictions: none. 
Registers at call: Return Registers: 
AX = D801h CF clear if successful 
CH = function number to read AH = 00h 
CL = slot number (including embedded and virtual) DS:SI buffer filled 
DS:SI -> 320-byte buffer for standard configuration CF set on error 

data block AH = error code: 


80h invalid slot number 
81h invalid function number 
82h EISA CMOS corrupt 
83h empty slot 
86h invalid BIOS-FW function call 
87h invalid system configuration 
BX destroyed 
Details: Call with AL=8 th if using 32-bit CS addressing mode instead of 16-bit. 
Conflicts: None known. 


INTERRUPT 15h - Function D8h, Subfunction 02h 
EISA SYSTEM ROM - CLEAR NONVOLATILE MEMORY (EISA CMOS) 


Purpose: Clear CMOS memory. 
Available on: EISA systems. Restrictions: none. 
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Registers at call: Return Registers: 
AX = D802h CF clear if successful 
BH = EISA config utility major revision level AH = 00h 
BL = EISA config utility minor revision level CF set on error 
AH = error code: 
84h error clearing CMOS 


86h invalid BIOS-FW function call 
88h config utility version not supported 
Details: Call with AL=82h if using 32-bit CS addressing mode instead of 16-bit. 
Conflicts: None known, 
See Also: Function D8h Subfunction 03h 


INTERRUPT 15h - Function D8h, Subfunction 03h 
EISA SYSTEM ROM - WRITE NONVOLATILE MEMORY 


Purpose: Write data to CMOS memory. 


Available on: EISA systems. Restrictions: none. 
Registers at call: Return Registers: 
AX = D803h CF clear if successful 
CX = length of data structure (0000h = empty slot) AH = 00h 
includes two bytes for config file checksum CF set on error 
DS:SI -> configuration data AH = error code 
84h error clearing CMOS 


85h EISA CMOS is full 

86h invalid BIOS-FW function call 
Details: Call with AL=83h if using 32-bit CS addressing mode instead of 16-bit. 
Conflicts: None known. 
See Also: Function D8h Subfunction 02h 


INTERRUPT 15h - Function D8h, Subfunction 04h 
EISA SYSTEM ROM - READ PHYSICAL SLOT 


Purpose: Reads slot information. 


Available on: EISA systems. Restrictions: none. 
Registers at call: Return Registers: 
AX = D804h CF clear if successful 
CL = slot number (including embedded and virtual) AH = 00h 


CF set on error 
AH = error code 
80h invalid slot number 
83h empty slot 
86h invalid BIOS-FW function call 
SI:DI = 4-byte compressed ID 
(DI = bytes 0&1, SI = bytes 2&3) 
Details: Call with AL=84h if using 32-bit CS addressing mode instead of 16-bit. 
Conflicts: None known. 
See Also: Function D8h Subfunction 00h 


INTERRUPT 15h - Function D8h, Subfunctions 80h to 84h 
EISA SYSTEM ROM - 32-bit CS ADDRESSING MODE CALLS 


Purpose: Distinguish between 16-bit and 32-bit information. 
Available on: EISA systems. Réstrictions: none. 
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Registers at call: Return Registers: 

AH =D8h as appropriate for AL=00h to 04h 
AL = 80h to 84h 

other registers as appropriate for AL=00h to 04h 


Details: These functions are identical to Function D8h Subfunctions 00h through 04h, except that they should be 
called when using 32-bit CS addressing mode (pointers use ESI rather than SI as offset) instead of 16-bit addressing 


mode, 
Conflicts: None known. 
See Also: Function D8h Subfunctions 00h through 04h 


Hewlett-Packard 


INTERRUPT 06h 
HP 95LX - SLEEP/WAKEUP 


Purpose: Called just before going into light or deep (shutdown) sleep and just after returning from a sleep. 


Available on: HP 95LX only Restrictions: none. 
Registers at call: n/a Return Registers: n/a 
Conflicts: CPU-generated INVALID OPCODE (chapter 2). 

INTERRUPT 5Fh 


HP 95LX - GRAPHICS PRIMITIVES 


Purpose: Provides a variety of useful graphics functions. 

Available on: HP 95LX only Restrictions: none. 
Registers at call: Return Registers: varies 
AH = function number (O0h-OFh) 

other registers vary 

Conflicts: DESQview IRQL5 (chapter 2), DoubleDOS IRQ7 (chapter 2). 

See Also: INT 60h 


INTERRUPT 60h 

HP 95LX SYSTEM MANAGER 

Purpose: Provide access to the System Manager program. 

Available on: HP 95LX only Restrictions: none. 
Conflicts: See Table 1-3 in chapter 1. 

See Also: INT 5Fh, INT 61h 


INTERRUPT 61h 

HP 95L.X SYSTEM MANAGER - LOAD DS 

Purpose: Called by the System Manager program to determine where it should store its data. 
Available on; HP 95LX only Restrictions: none. 

Conflicts: See Table 1-3 in chapter 1. 

See Also: INT 5Fh, INT 60h 


INTERRUPT 6Fh - Function 0012h, Subfunction 22h 
HP ES-12 EXTENDED BIOS - READ CMOS MEMORY 


Purpose: Read a byte from CMOS memory, 


Available on: HP ES-12 Extended BIOS. Restrictions: none. 
Registers at call: Return Registers: 
BP = 0012h AH = status 

AH = 22h AL = byte read 

BL = address of CMOS byte to read BP, DS destroyed 


Conflicts: Novell NetWare PCOX API (chapter 20), 10-Net (chapter 23). 
See Also: Function 0012h Subfunction 24h 
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4-12 Vendor-Specific ROM BIOS Extensions 


INTERRUPT 6Fh - Function 0012h, Subfunction 24h 
HP ES-12 EXTENDED BIOS - WRITE CMOS MEMORY 


Purpose: Write a byte to CMOS memory. 


Available on: HP ES-12 Extended BIOS. Restrictions; none. 
Registers at call: Return Registers: 
BP =0012h AH & status 

AH = 24h BP, DS destroyed 


BL = address of CMOS byte to write 

AL = new value 

Conflicts: Novell NetWare PCOX API (chapter 20), 10-Net (chapter 23). 
See Also: Function 0012h Subfunction 22h 


Phoenix BIOS 


INTERRUPT 15h - Function BCh 
DETERMINE CPU SPEED 


Purpose: Determine CPU operating speed. 
Available on: Systems using Phoenix 386 BIOS Restrictions: none. 
chips, 
Registers at call: Return Registers: 
AH =BCh CF clear 
BYTE 0040h:00B0h set to relative speed 
(higher = faster CPU) 
Details: The computed speed is affected by whether or not the BIOS is shadowed, 
Conflicts: None known. 


Texas Instruments 


INTERRUPT 49h 
Texas Instruments PC - VIDEO /0 


Purpose: Apparently provides direct video display on the TI Professional PC, 

Available on: TI Professional PC only. Restrictions: none. 
Registers at call: unknown. Return Registers: unknown. 
Conflicts: None known. 


Victor 


INTERRUPT DFh 
Vietor 9000 SuperBIOS 


Purpose: unknown. 

Available on: Victor model 9000 only. Restrictions: none. 
Registers at call: unknown. Return Registers: unknown. 
Conflicts: None known, 


Zenith 


INTERRUPT 69h 

Zenith AT BIOS - Unknown Function 

Purpose: called by INT 09h handler. 

Available on: Zenith 80286 models only. Restrictions: none. 
Registers at call: unknown. Return Registers: unknown. 
Conflicts: DECnet DOS CTERM (chapter 24). 


Vendor-Specific ROM BIOS Extensions 4-13 


INTERRUPT FFh 

Z100 - WARM BOOT 

Purpose: Re-boots the system. 

Available on: Heath-Zenith Z-100 only. Restrictions: none. 
Registers at call: n/a Return Registers: n/a. 


Confliets: AT/XT286/PS50+ return from protected mode (chapter 1). 
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Chapter a 5 





Video 


Virtually all IBM and video-compatible systems use the BIOS interface at INT 10h to control video actions. Although 
this conflicts with the CPU-generated Coprocessor Error fault described in chapter 2, the conflict is not specifically 
mentioned in this chapter since it would apply to all uses of INT 10h for any interfacing purpose. 

There are some additional calls related to video services in other chapters. TopView virtual screen support on INT 
10h is covered in chapter 15, Alloy NINX and 386/MultiWare screen-related calls are discussed in chapter 18, and 
MultiDOS screen-related calls on INT 15h are listed in chapter 16. 


INTERRUPT 10h - Function 00h 


SET VIDEO MODE 
Purpose: Establishes CRT operating conditions. 
Available on: All machines. Restrictions: none, 
Registers at call: Return Registers: 
AH = 00h AL = video mode flag (Phoenix BIOS): 
AL= mode (see Table 5-1) 20h mode > 7 
30h modes <= 7 except mode 6 
3Fh mode 6 
AL = CRT controller mode byte (Phoenix 386 BIOS 
vI.10) 


Details: IBM standard modes do not clear the screen if the high bit of AL is set (EGA or higher only). 
The Tseng ET-4000 chipset is used by the Orchid Prodesigner II, Diamond SpeedSTAR VGA, and Groundhog 
Graphics Shadow VGA. 
Conflicts: None known other than those shown in table. 
See Also: Function 00h Subfunctions 70h and 7Eh, Function 6Fh Subfunction 05h 


Table 5-1. Values for Video Mode 


TEXT/ TEXT PIXEL — PIXEL DISPLY SCRN 
GRPH RESOL BOX RESOLTN COLORS PAGES ADDR SYSTEM 
00h = T 40x25 8x8 l6gray 8 B800 CGA,PCjr 
=T 40x25 8xl4 l6gray 8 B800 EGA 
=T 40x25 8x16 6 8 B800 MCGA 
=T 40x25 9x16 6 8 B800 VGA 
Olh=T 40x25 8x8 6 8 B800 CGA,PCjr 
=T 40x25 8x14 6 8 B800 EGA 
=T 40x25 8x16 6 8 B800 MCGA 
=T 40x25 9x16 6 8 B800 VGA 
02h =T 80x25 8x8 l6gray 4 B800 CGA,PCjr 
=T 80x25 8x14 l6gray 4 B800 EGA 
=T 80x25 8x16 6 4 B800 MCGA 
=T 80x25 9x16 6 4 B800 VGA 








5-1 


5-2 Video 


Table 5-1. Values for Video Mode (continued) 


TEXT/ = TEXT PIXEL PIXEL DISPLY SCRN 
GRPH ~RESOL BOX RESOLTN COLORS PAGES ADDR SYSTEM 
03h=T 80x25 8x8 16 4 B800 CGA,PCjr 
=T 80x25 8x14 16 4 B800 EGA 
=T 80x25 8x16 16 4 B800 MCGA 
=T 80x25 9x16 16 4 B800 VGA 
04h =G 40x25 8x8 320x200 4 B800 CGA, PCjr,EGA, MCGA, VGA 
05h = G 40x25 8x8 320x200 4gray B800 CGA, PCjr, EGA 
=G 40x25 8x8 320x200 4 B800 MCGA, VGA 
06h =G 80x25 8x8 640x200 2 B800 CGA, PCjr, EGA, MCGA, VGA 
O7h=T 80x25 9x14 mono var BOOO MDA, Hercules, EGA 
= 80x25 9x16 mono BOO VGA 
08h = G 20x25 8x8 160x200 16 PCjr 
=T 132x225 8x8 16 B800 ATI EGA/VGA Wonder ** 
=T  132x25 8x8 mono BO0O ATI EGA/VGA Wonder ** 
=G = 90x43 8x8 720x352 ~=mono BO00 Hercules +MSHERC.COM 
09h = G 40x25 8x8 320x200 = 16 PCjr 
OAh=G 80x25 8x8 640x200 4 PCjr 


OBh = reserved (used internally by EGA BIOS) 
OCh = reserved (used internally by EGA BIOS) 


ODh=G 40x25 8x8 320x200 16 8 A000 EGA,VGA 
OEh=G 80x25 8x8 640x200 16 4 A000 EGA,VGA 
OFh = G 80x25 8x14 640x350 mono 2 A000 EGA,VGA 
10h=G 80x25 8x14. 640x350 4 2 A000 64k EGA 
=G 640x350 16 A000 256k EGA, VGA 
llh=G 80x30 8x16 640x480 mono A000 VGA, MCGA, ATIEGA, ATI VIP 
12h=G 80x30 8x16 640x480 16/256k A000 VGA,ATI VIP 
=G 80x30 8x16 640x480 16/64 A000 ATI EGA Wonder 
=G 640x480 16 UltraVision+25KEGA 
13h=G 40x25 8x8 320x200 256/256k A000 VGA,MCGA,ATI VIP 
4h=G 80x25 8x8 640x200 Lava Chrome Il EGA 
=G 640x400 16 Tecmar VGA/AD 
15h=G 80x25 8x14 640x350 : Lava Chrome IIEGA 
16h=G 80x25 8x14 640x350 Lava Chrome II EGA 
uG 800x600 16 Tecmar VGA/AD 





** For ATI EGA Wonder, mode 08h is only valid if SMS.COM is loaded resident. SMS maps mode 08h to mode 
27h if the byte at location 0040;:0063 is OB4h, otherwise to mode 23h, thus selecting the appropriate (monochrome or 
color) 132x25 character mode, For ATI VGA Wonder, mode 08h is the same, and only valid if VCONFIG loaded 
resident. 
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TEXT/ = TEXT PIXEL 
GRPH —RESOL BOX 


imh=G 80x34 8x14 
=T  132x25 


18h=T 132x44 8x8 

=T 132x44 8x8 
=G 80x34 8x14 
=G 


132x25 8x14 
=T 132x25 8x14 


1Ah=T 132x28 8x13 
= 132x28 8x13 

{Bh=G 

1Ch=G 

{Dh =G 

2th=G 80x43 8x8 

22h =T 132x44 8x8 
=T 132x44 8x8 
=T 132x44 8x8 
=T = 132x44 8x8 
=T = 132x44 
=T = 132x43 
=G 80x43 8x8 

23h =T 132x25 6x14 
=T = 132x25 8x14 
=T = 132x25 8x14 
=T 132x25 8x14 
=T = 132x25 8x8 
=T = 132x28 
=T = [32x28 

24h = T 132x28 6x13 
=T  132x28 8x13 
=T = 132x28 = 8x12 
=T = 132x25 
=T = 132x25 

25h =G 80x60 8x8 
=G 80x60 8x8 
=G 
=G 80x60 8x8 
=G 80x60 8x8 


Table 5-1. Values for Video Mode (continued) 


PIXEL 
RESOLTN COLORS 


640x480 


640x480 
1024x768 


640x350 
640x400 
640x480 
800x600 
720x348 


720x348 


640x480 
640x480 
640x480 
640x480 
640x480 





st DESQview intercepts calls to change into these two modes (21h is page 0, 22h is page 1) even if there is no 


Hercules graphics board installed. 


mono 
16/256 


mono 
16/256 


mono 
16/256 
256 


256 
256 
256 


mono 


16/256 
16 


mono 


16/256 


16 
16 


16 


16/256 
16 


16 


16/256 
16 
16 
16 


DISPLY SCRN 


PAGES ADDR 
2 Bo000 
16 
4 BO000 
4 BO00 

BO00 

2: Ba00 

2 B800 
16 

B800 

4 B800 

4 B800 

B800 

4 B800 

1 B800 

it A000 

A000 

1 A000 


Video 5-3 


SYSTEM 


Lava Chrome ITIEGA 
Tecmar VGA/AD 


Tseng Labs EVA 
Tseng ET-4000 chipset 
Lava Chrome HEGA 
Tecmar VGA/AD 


Tseng LabsEVA 
Tseng ET-4000 chipset 


Tseng Labs EVA 
Tseng ET-4000 chipset 
Tecmar VGA/AD 


Tecmar VGA/AD 
Tecmar VGA/AD 
Tecmar VGA/AD 


Tseng Labs EVA 

Tseng ET-4000 chipset 

Ahead Systems EGA2001 
Ahead B 

Orchid Prodesigner VGA 
Allstar Peacock (VGA) 
DESQview 2.x + Hercules *** 


Tseng Labs EVA 

Tseng ET-4000 chipset 
Ahead Systems EGA2001 
Ahead B 

ATLEGA Wonder, ATI VIP 
Allstar Peacock (VGA) 
Orchid Prodesigner VGA 


Tseng LabsEVA 

Tseng ET-4000 chipset 
Ahead B 

Allstar Peacock (VGA) 
Orchid Prodesigner VGA 


Tseng Labs EVA 

Tseng ET-4000 chipset 
VEGA VGA 

Orchid Prodesigner VGA. 
Ahead B (same as 26h) 


5-4 Video 


Table 5-1. Values for Video Mode (continued) 


TEXT/ 
GRPH 


26h =T 


ioe u we 
34005 


27h = 


4a? 


nou 


ny 
N= Co 
oa sr 
i 
aaaa® 7 


aw 


nr 

> 

Za 
ant 
a4 


nD 
oO 
> 


nu 


iS 

fea 

a 
aaae ane 


2 
nual 


qaae 


30h = 


Q 


nun eat 
Q20Q000 


TEXT 
RESOL 


80x60 
80x60 
80x60 
80x60 
80x60 
80x60 


132x25 


100x37 


100x37 


100x40 
100x40 
100x40 


80x25 


80x30 
80x30 


80x25 
160x50 


100x37 


100x37 
80x34 


132x44 
80x34 


80x66 


128x48 
132x44 


PIXEL 
BOX 


8x8 
8x8 
8x8 
8x8 


8x8 


8x16 


8x16 


8x16 
8x15 


8x14 


8x16 
8x16 


8x16 
8x8 


8x16 


8x16 
8x10 


8x8 
8x8 


8x8 


8x16 
8x8 


PIXEL 
RESOLTN COLORS 


16/256 
640x480 
640x480 16 


720x512 
720x512 


800x600 6 
800x600 6 
800x600 6 
800x600 6 
800x600 16/256 





6 
16/256 


640x350 256 
640x350 256/256k 
640x350 256/256k 


640x480 256 

640x480 256/256k 
640x480 256/256k 
640x480 256/256k 


720x512 256 
720x512 256 
640x400 256/256k 
1280x400 16 


800x600 256 
800x600 256/256k 
800x600 256/256k 
720x350 2 
800x600 256 


800x600 256/256k 
16 


16 
16 


16 


960x720 16 
960x720 16 


1024x768 16 

1024x768 16 

1024x768 16 
mono 


2 


DISPLY SCRN 
PAGES ADDR 


B800 
A000 


BO00 


A000 
A000 


A000 


B800 


A000 
A000 


A000 
A000 
A000 


A000 
A000 


A000 
A000 


B800 
A000 


B800 


B800 
B800 


B800 


A000 
A000 
B800 


SYSTEM 


Tseng LabsEVA 

Tseng ET-4000 chipset 
Ahead Systems EGA2001 
Ahead B (same as 25h) 
Allstar Peacock (VGA) 
Orchid ProDesigner VGA 


VEGA VGA 
Genoa 
ATI EGA Wonder, ATI VIP 


VEGA VGA 


VEGA VGA 

Orchid 

STB, Genoa, Sigma 
Allstar Peacock (VGA) 
Tseng ET-4000 chipset 


Allstar Peacock (VGA) 
Orchid Prodesigner VGA 
Tseng ET-4000 chipset 


VEGA VGA 
Orchid, Genoa, STB 
Tseng ET-4000 chipset 


VEGA VGA 

Orchid 

STB, Genoa, Sigma 
Tseng ET-4000 chipset 


VEGA VGA 

Genoa 

Tseng ET-4000 chipset 
Ahead B (Wizard/3270) 


VEGA VGA 

Orchid 

STB, Genoa, Sigma 
3270 PC 

Cardinal 

AT&T 6300 

Tseng ET-4000 chipset 


Ahead B (Wizard/3270) 


ATI EGA Wonder, ATI VIP 
Ahead B (Wizard/3270) 


Ahead B (Wizard/3270) 


VEGA VGA 
STB 


VEGA VGA 

Orchid 

STB, Genoa, Sigma 

ATI EGA Wonder, ATI VIP 


Table 5-1. Values for Video Mode (continued) 


TEXT/ 
GRPH 


38h = G 
=G 


40h = G 


nau i 


44450 


4th= 


wou il 
Aa4° 


42h = 


Q 


nun u 
S444 


43h 


it) 
Q 


4444 


Hoa ou tl 


tug tnu 
44q04n 


TEXT 
RESOL 


128x48 


80x25 
80x25 
80x43 
80x43 
80x43 


132x25 
132x25 
132x25 


80x25 
132x43 
132x43 
132x43 
80x34 


80x60 
80x60 
80x60 
80x45 


PIXEL 
BOX 


8x16 


8x16 
8x16 


8x16 


9x10 


PIXEL DISPLY SCRN 
RESOLTN COLORS PAGES ADDR 


1024x768 256 


1024x768 256/256k 1 A000 
640x400 2 1 B800 
640x400 2 1 B800 
640x200 16 1 
640x400 16 

4 4 B800 


Video 5-5 


SYSTEM 


STB VGA/EM-16 Plus (IMB) 
Tseng ET-4000 chipset 


AT&T 6300, AT&T VDC600 
Compaq Portable 

VEGA VGA, Tecmar VGA/AD 
Video7 V-RAM VGA 

Tatung VGA 


AT&T 6300 
VEGA VGA 
Tatung VGA 
Video? V-RAM VGA 


AT&T 6300, AT&T VDC600 
VEGA VGA 

Tatung VGA. 

Video7 V-RAM VGA 

Ahead B(Wizard/3270) 


640x200 of 640x400 viewport AT&T 6300(unsupported) 


9x8 


4 4 B800 


disable VDC and DEB outputAT&T 6300 


100x60 
100x60 
100x60 


132x28 
132x28 


100x40 
100x37 

80x50 

80x30 
120x25 
120x43 
132x25 


80x30 
80x30 
80x34 
80x43 


132x25 
132x25 
132x25 


8x15 
8x16 
8x8 

8x16 


8x16 
8x16 


9x14 
9x14 
8x14 


800x600 2 
800x600 16 
640x400 2 B800 
640x480 
640x480 16 
16/256k B800 
mono 
640x480 mono??? 
mono 
4 4 B800 
16 8 B800 


VEGA VGA 

Tatung VGA 

Video? V-RAM VGA 
Ahead B (Wizard/3270) 


VEGA VGA 
Tatung VGA 
Video7 V-RAM VGA 


Tatung VGA 
Video7 V-RAM VGA 


AT&T VDC600 

AT&T VDC600 

AT&T 6300, AT&T VDC600 
Lava Chrome Il EGA 

VEGA VGA 

VEGA VGA 

VEGA VGA 


Paradise EGA-480 

Trident TVGA 8800/8900 
Lava Chrome J] EGA 
VEGA VGA 

Taxan'565 EGA 

Ahead Systems EGA2001 
Ahead B 

OAK Technologies VGA-16 








} 


5-6 Video 


Table 5-1, Values for Video Mode (continued) 


TEXT/ 
GRPH 


Slh=T 


Hint teu 
B4844o04 


iw 
wR 
> 
il 

= 


unui ta 


444004 


wn Aa 

— w 

as a 

I H 
ou 

a bho 


oii dd a eu 
AAsssssRs 


wa 
a 
> 
i] 

3 


QO433444H4 


56h =T 


oe ou 
Saan4 


Ik 


TEXT 
RESOL 


80x30 
80x30 
80x34 
80x43 
132x25 
132x43 
132x28 


80x60 
80x60 
94x29 
100x75 
132x43 
132x44 
132x44 


100x40 
132x25 
132x43 


100x42 
132x25 
132x30 
132x43 
132x43 
132x43 
132x43 
132x43 
132x43 
132x43 


80x66 
132x25 
132x25 
132x25 
132x25 
132x25 
132x25 
132x25 
132x43 

94x29 
128x48 


132x43 
132x43 
132x43 
132x43 
132x43 
132x60 


PIXEL 
BOX 


8x16 


8x14 
8x11 


8x8 
9x12 


8x8 
8x14 
8x8 


9x8 
9x8 


8x14 
8x14 


8x14 


8x16 
8x8 

Tx9 

8x9 


Tx9 


8x8 
8x14 
7x16 
8x16 


7x16 
8x11 
8x14 
8x16 


8x8 
1x9 
8x9 


7x9 
8x8 


PIXEL 
RESOLTN COLORS 


640x480 16 
16/256k 
mono 
16 
4 


16/256k 
752x410 16 
800x600 16 
mono 


800x560 16 


800x600 = 16 
16/256k 


16/256k 
16/256k 


16 
16/256k 


16/256k 
16/256k 


16 
16/256k 
752x410 
1024x768 16/256k 


322? 
4 
4 
mono 
2 
16/256k 





*! ATI BIOS v4-1.00 has a text-scrolling bug in this mode. 


DISPLY SCRN 
PAGES ADDR 


B800 


5 B800 
4 B800 


B800 
1 A000 


2 B800 


B800 


A000 
B800 


B800 
B800 


A000 


B800 
B800 


B800 


A000 


2 BO00 
BO000 
BOo00 


B800 


SYSTEM 


Paradise EGA-480 

Lava Chrome Il EGA 
ATIEGA Wonder 

Trident TVGA 8800/8900 
VEGA VGA 

OAK Technologies VGA-16 
Ahead B 


Lava Chrome II EGA 
Trident TVGA 8800/8900 
ATI EGA Wonder 

OAK Technologies VGA-16 
VEGA VGA 

Ahead Systems EGA2001 
Ahead B 


ATI EGA Wonder, ATI VIP 
Trident TVGA 8800/8900 
Lava Chrome Il EGA. 


ATIEGA Wonder, VGA Wonder 
Lava Chrome II EGA 

Trident TVGA 8800/8900 
Paradise EGA-480 

Paradise VGA 

Paradise VGA on multisyne 
Taxan 565 EGA 

AST VGA Plus 

Hewlett-Packard D1180A 

AT&T VDC600 


ATI VIP 

Paradise EGA-480 
Paradise VGA 

Paradise VGA on multisyne 
Taxan 565 EGA 

AST VGA Plus 
Hewlett-Packard D1180A. 
AT&T VDC600 

Trident TVGA 8800/8900 
Lava Chrome II EGA 
ATI VGA Wonder v4+ *! 


NSI Smart EGA+ 

Paradise VGA 

Paradise VGA on multisyne 
Taxan 565 EGA 

AT&T VDC600 

Trident TVGA 8800/8900 





Table 5-1. Values for Video Mode (continued) 


TEXT/ 
GRPH 


57h =T 


HR UW ON 
Saad 


wv 
a 
> 
I 

Q 


nun tow 
Aaa0nm 


59h 


Hi] 
Q 


AQAQAAKA 


Woh on i 


wow 
ee 
bd 


nan 


5Ch 


aa209 aaAaae 4400 4 


wu 
=] 
=a 


wv 
fs] 
> 


anounnuna # 


wa 
= 
ag0g0a0° 


aaaaaaaae 


TEXT 
RESOL 


32x25 
32x25 
32x25 
32x25 
32x25 
32x25 


00x75 
00x75 
80x33 


32x30 


00x75 
100x75 
80x66 





132x43 
132x60 


80x30 


100x75 


80x25 


80x30 


80x25 


80x30 


128x48 


PIXEL 
BOX 


8x14 
Tx 
8x 


6 

6 

7x16 

9x14 
8x8 
8 

4 


8x 
8x 





8x16 


8x16 


8x16 


8x16 


8x16 





PIXEL 
RESOLTN COLORS 
372? 
4 
4 
mono 
2 
16/256k 
800x600 16/256k 
800x600 16 
16 
800x600 16 
800x600 16 
800x600 16 
16/256k 
800x600 2 
800x600 2 
16/256k 
800x600 Z 
800x600 2 
800x600 2 
16/256k 
16/256k 
800x600 16 
640x350 =. 256 
800x600 16/256k 
640x400 256 
640x400 256 
640x400 = 256 
640x400 256 
640x480 256 
640x480 256 
640x480 256 
640x480 256 
640x480 256 
640x400 256 
640x400 256 
640x400 256 
640x400 256 
800x600 16 
800x600 256 
800x600 256 
640x480 256 
640x480 256 
640x480 256 
640x480 =. 256 
640x480 256 
1024x768 16 
1024x768 16 
1024x768 16 
1024x768 16/256k 


DISPLY SCRN 
PAGES ADDR 


4 


BO00 
BO00 
BO000 


B800 
A000 


B800 


B800 
A000 


A000 


B800 
B800 


B800 


A000 


A000 


A000 


A000 


Video 5-7 


SYSTEM 


NSI Smart EGA+ 

Paradise VGA 

Paradise VGA on multisync 
Taxan 565 EGA 

AT&T VDC600 

Trident TVGA 8800/8900 


Paradise VGA 

AT&T VDC600 

ATI EGA Wonder, ATI VIP 
AST VGA Plus, Compaq VGA 
Dell VGA 

Hewlett-Packard D1180A. 
Trident TVGA 8800/8900 


Paradise VGA 

AT&T VDC600 

ATI VIP 

AST VGA Plus, Compaq VGA 
Dell VGA 

Hewlett-Packard D1180A 
Trident TVGA 8800/8900 


Trident TVGA 8800/8900 


Maxxon, SEFCO TVGA, Imtec 
Genoa 6400 

ATI VGA Wonder (undoc) 
Trident TVGA 8800/8900 


Logix, ATI Prism Elite 
Maxxon, SEFCO TVGA, Intec 
Zymos Poach 

Trident TVGA 8800/8900 
Genoa 6400 


Logix, ATI Prism Elite 
Maxxon, SEFCO TVGA, Imtec 
Zymos Poach 

Trident TVGA 8800 (512K) 


Paradise VGA, VEGA VGA 
AST VGA Plus 

Compaq VGA, Dell VGA 
AT&T VDC600 

Logix, ATI Prism Elite 
Genoa 6400 

Zymos Poach, Trident 8900 


Paradise VGA. 

AST VGA Plus 

Compaq VGA, Dell VGA 
Hewlett-Packard D1180A 
AT&T VDC600 (512K) 

Logix, ATI Prism Elite 
Maxxon, Genoa 6400, Imtec 
Zymos Poach 

Trident TVGA 8800/8900 512K 
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Table 5-1. Values for Video Mode (continued) 





TEXT/ ~— TEXT 
GRPH  RESOL 
60h =G 80x??? 
=G 
=G 
=G 
=G 80x25 
=G — 128x48 
=T 132x258 
6lh=G 
=G 
=G 
=G 
=G 80x25 
=G 80x30 
=G 96x64 
=T 32x29 
62h=G 
=G 
=G 
=G 80x30 
=G 00x75 
=G 28x48 
=T 32x32 
63h =G 
=G 00x42 
=G 28x48 
=T = 132x44 
64h=G 
=G — 128x48 
65h=G 
=G — 128x48 
66h =G 
=G 
67h =G 
=G  128x48 
69h =G 
6Ah=G 
=G 
=G — 100x75 
=G 
=G 
=G 
=G 100x42 
Wh=G 
G 90x28 


40x25 


16 
70h with Everex Micro Enhancer EGA (see Func 00h Subfunc 70h) 


PIXEL 
BOX 


go 
x 
NAAD 





8x16 


8x8 


8x14 


8x14 
8x8 


PIXEL 
RESOLTN COLORS 
27400 
752x410 
752x410 16 
752x410 16 
640x400 =. 256 
1024x768 4/256k 

16/64 
222x400 
720x540 
720x540 16 
720x540 16 
640x400 256 
640x480 256 
7768x1024 16/256k 

16/64 
800x600 
800x600 16 
800x600 16 
640x480 = 256 
800x600 256 
1024x768 256/256k 

1/64 
1024x768 92 
800x600 256 
1024x768 256 

16/64 
1024x768 4 
1024x768 256 
1024x768 16 
1024x768 16 
640x400 256 
640x400 256 
640x480 256 
1024x768 4 
720x540 256 
800x600 «16 
800x600 16 
800x600 16 
800x600 16 
800x600 = «16 
800x600 16 
800x600 
800x600 16 
720x392 16 


DISPLY SCRN 
PAGES ADDR 


1 
8 


A000 
A000 
B800 


A000 
A000 
A000 
B800 


A000 
A000 
A000 
B800 


A000 
A000 
B800 


A000 


A000 


A000 


A000 
A000 


A000 


A000 
B800 


SYSTEM 


Corona/Cordata BIOS 4.10+ 
VEGA VGA 

Tatung VGA 

Video7 V-RAM VGA 
Ahead B 

Trident TVGA 8900 
Quadram Ultra VGA 


Corona/Cordata BIOS 4.10+ 
VEGA VGA 

Tatung VGA 

Video7 V-RAM VGA 

ATI VGA Wonder 

Ahead B 

Trident TVGA 8800/8900 512K 
Quadram Ultra VGA 


VEGA VGA 
Tatung VGA 
Video? V-RAM VGA 

ATI VGA Wonder 

Ahead B (512K) 

Trident TVGA 8900, Zymos 
Quadram Ultra VGA 


Video7 V-RAM VGA 
ATI VGA Wonder 
Ahead B (1MB) 
Quadram Ultra VGA 


Video7 V-RAM VGA 
ATI VGA Wonder Plus 


Video7 V-RAM VGA 
ATI VGA Wonder 


Tatung VGA 
Video7 V-RAM VGA 


Video7 V-RAM VGA 
ATI VGA Wonder 


Video7 V-RAM VGA 


VESA standard interface 

Genoa 6400 

Ahead B (VESA) (see 71h) 
Zymos Poach 

Epson LT-386SX in CRT mode 
Compuadd 316SL in CRT mode 
ATI VGA Wonder (undoc) 


Cardinal, C&T chipset 
Ahead B 
Quadram (CGA double scan) 





Table 5-1. Values for video mode (continued) 





TEXT/ 
GRAPH 
Th=G 
=G 
=G 
=T 
72h=G 
=T 
BheG 
74h =G 
=G 
=T 
75h =G 
=G 
T6h=G 
=T 
ThsG 
78h = G 
=G 
=T 
79h=G 
=G 
TAh= G 
7Bh= G 
=G 
7Ch=G 
7Dh = G 


TEXT 
RESOL 
100x35 
100x75 
80x25 
80x60 
80x60 
128x48 
80x66 


128x48 
80x66 


128x48 
94x29 


94x29 


100x75 


100x75 


114x60 


114x60 


PIXEL 
BOX 
8x16 
8x8 
8x8 
8x8 
8x8 
8x8 
8x8 
8x16 


8x16 
8x14 


8x8 


8x8 


PIXEL 


DISPLY SCRN 


RESOLTN COLORS PAGES ADDR 


800x600 
960x720 
800x600 


1024x768 


640x480 
640x400 
1024x768 
1024x768 
640x528 


1024x768 


752x410 
640x400 
640x400 
640x480 
800x600 
720x540 
800x600 
912x480 
512x512 
512x512 


16/64 
16 
16 
16 


16 
16 


1622? 


256 


7Eh = special mode set (see Func 00h Subfune 7Eh) 


7Fh = special function set (see Func 00h Subfunc 7Fh) 


82h=T 
83h=T 
86h =G 
88h=G 
C0h=G 


80x25 
80x25 


90x43 


C4h = disable output 


DOh=G 


8x8 


640x200 
720x352 
640x400 


640x400 





B&W 


B&W 


mono 


2 


A000 
1 A000 
8 B800 
B800 
A000 
B800 
1 A000 
B800 


1 A000 
A000 


1 A000 
B800 


A000 


B800 


A000 


B800 


A000 


B800 


2/prog pallet 


B800 
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SYSTEM 

NSI Smart EGA+ 

Cardinal 

Ahead B (same as 6Ah) 
Quadram (CGA double scan) 


Cardinal, C&T chipset 
Quadram Ultra VGA 


Quadram Ultra VGA 
Toshiba 3100 AT&T mode 
Ahead B (512K) 

Quadram Ultra VGA 


Ahead B 
Quadram Ultra VGA 


Ahead B 
Quadram Ultra VGA 


Quadram Ultra VGA 
STB VGA/EM-16 Plus 
Cardinal, C&T chipset 
Quadram Ultra VGA 


Cardinal, C&T chipset 
Quadram Ultra VGA 


Cardinal 
Quadram Ultra VGA 








Cardinal 
Quadram Ultra VGA 


Genoa 


Genoa 


Paradise VGA, AT&T VDC600 
Paradise VGA, AT&T VDC600 


AT&T VDC overlay mode * 
AT&T VDC overlay mode * 
AT&T VDC overlay mode * 
Hercules + MSHERC.COM 
AT&T VDC overlay mode * 
AT&T VDC overlay mode * 
DEC VAXmate AT&T mode 


* For AT&T VDC overlay modes, BL contains the DEB mode, which may be 06h, 40h, or 44h, 
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INTERRUPT 10h - Function 00h, Subfunction 70h 


Everex Micro Enhancer EGA/Viewpoint VGA - EXTENDED MODE SET 


Purpose: Select a non-standard Everex-specific video display mode. 
Restrictions: none. 


Available 


Registers at 
AX = 0070h 


on: Systems 


equipped with 


the 


applicable video cards listed below. 


call: 


BL = mode (see Table 5-2) 


Conflicts: None known. 
See Also: Function 00h, Function 6Fh Subfunction 05h 


Table 5-2, Everex-specific Values for video mode 


TEXT/ 
GRPH 


00h =G 
Olh=G 
02h=G 
03h = T 
04h =T 
05h =T 
06h =T 
07h =T 
08h = T 
09h =T 
OAh=T 
OBh=T 
0Ch=T 
ODh=T 
OEh=T 
OFh = T 


TEXT 
RESOL 


80x34 
80x60 
94x29 
94x51 
100x43 
100x75 
80x44 
132x25 
132x44 
132x25 
80x44 
132x25 
132x44 


10h =reserved 


1th=G 
12h=G 
13h=G 
14h=G 
i5h=G 
16h =T 
18h=T 
20h =G 


80x30 
100x27 


PIXEL 
BOX 


8x14 
8x8 


8x16 
8x16 


PIXEL 
RESOLTN COLORS 
640x480 = 16 
752x410 16 
800x600 16 

16 

16 

1280x3504 

1280x600 4 
640x350 © 256 
640x400 = 256 
312x480 256 
256 

16 

1024x768 16 


DISP — SCRN 
PAGE ADDR 


MONITOR 
multsyne 
multsyne 
multsyne 
multsyne 
multsyne 
multsyne 


multsyne 


EGA 
EGA 
EGA 
CGA 
mono 
mono 


mono 


ADAPTER 
EGA,VGA 
EGA,VGA 
EGA,VGA 
EGA,VGA 
EGA,VGA 
EGA only 
EGA only 
VGA only 
VGA only 
EGA only 
EGA, VGA 
EGA, VGA 
EGA only 
EGA only 


EGA only 
EGA only 
EGA only 


VGA only 
VGA only 
Everex 629, 678 only 
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Table 5-2. Everex-specific Values for video mode (continued) 


TEXT/ = TEXT PIXEL PIXEL DISP_  SCRN 

GRPH = RESOL BOX RESOLTN COLORS PAGE ADDR MONITOR ADAPTER 
21h=T 160x64 8xl6 = 1280x1k_— «16 1MB VGA only 
30h=G 640x480 256 Everex 629, 678 only 
3lh=G 800x600 256 Everex 629, 678 only 
32h=G 128x48 8x16 1024x768 256 1MB VGA only 
40h =T 132x30 8x16 16 VGA only 
50h =T 132x32 8x16 mono VGA only 
62h=G 40x25 8x8 320x200 32K Viewpoint TC (EV629) 
70h =G 64x30 8x16 512x480 932K Viewpoint TC 
Th=G 80x30 8x16 640x480 332K Viewpoint TC 
Teh=G 64x30 8x16 512x480 16M Viewpoint TC 
TM=G 80x30 8x16 640x480 = 16M. Viewpoint TC 


INTERRUPT 10h - Function 00h, Subfunction 7Eh 


SET SPECIAL VIDEO MODE 


Purpose: Set special extended modes, 
Available on: Paradise VGA, AT&T VDC600 


only. 


Registers at call: 


AX = 007Eh 


BX = The horizontal dimension of the mode desired 


Restrictions: none. 


Return Registers: 
BH = 7Eh if successful (Paradise VGA) 
AL = 7Eh if successful (AT&T VDC600) 


CX = The vertical dimension of the mode desired 
(both BX/CX in pixels for graphics 
modes, rows for alpha modes) 
DX = The number of colors of the mode desired 
{use 0 for monochrome modes) 
Conflicts: None known. 
See Also: Function 00h, Function 00h Subfunctions 70h and 7Fh, Function 6Fh Subfunction 05h 


INTERRUPT 10h - Function 00h, Subfunction 7Fh 
EXTENDED VIDEO MODE FUNCTIONS 


Purpose: Provides extended control of video actions. 


Available on: Paradise VGA, AT&T VDC600 Restrictions: none. 
only, 
Registers at call: Return Registers: 
AX = 007Fh AL = 7Fh if successful (AT&T VDC600) 


BH = 00h set VGA operation 
Olh set non-VGA operation 
color modes (0, 1, 2, 3, 4, 5, 6) will 
set non-VGA CGA operation. 
monochrome mode 7 will set non- 
VGA MDA/Hercules operation. 
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02h query mode status BL = 00h if operating in VGA mode, 
Olh if non-VGA mode. 
CH = total video RAM size in 64k byte units, 
CL = video RAM used by the current mode. 
03h lock current mode 
allows current mode (VGA or non- 
VGA) to survive re-boot, 
04h enter CGA mode 
(AT&T VDC600 only) 
05h enter MDA mode 
(AT&T VDC600 only) 
OAh, OBh, OCh, ODh, OEh, OFh WRITE 
PARADISE REGISTERS 0, 1, 2, 3, 4,5 
(port 03CEh indices OAh, OBh, 0Ch, 


ODh, OEh, OFh) 
BL = value to set in the Paradise 
register. 
1Ah, 1Bh, 1Ch, 1Dh, 1Eh, 1Fh READ BL = value of the Paradise register. 
PARADISE REGISTERS 0, 1, 2, 3, 4,5 BH = 7Fh if successful. 
(port 03CEh indices OAh, OBh, 0Ch, 
ODh, 0Eh, OFh) 


Conflicts: None known. 
See Also: Function 00h Subfunction 7Eh 


INTERRUPT 10h - Function 01h 
SET TEXT-MODE CURSOR SIZE 


Purpose: Sets size of text-mode cursor, 


Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: n/a. 
AH= 01h 


CH =bit7 should be zero 
bits 6,5 cursor blink (00 = normal, 
01 = invisible, 10 = erratic, 
11 = slow) 
(00 = normal, other = invisible on 
EGA/VGA) 
bits 4-0 top scan line containing cursor 
CL = bottom scan line containing cursor (bits 0-4) 
Details: Buggy on EGA systems--the BIOS remaps the cursor shape in 43 line modes, but returns the unmapped 
cursor shape. 
UltraVision scales the size to the current font height by assuming 14-line monochrome and 8-line color fonts; 
this call is not valid if cursor emulation has been disabled. 
Applications which wish to change the cursor by programming the hardware directly on EGA or above should 
call INT 10h Function 11h Subfunction 30h or read 0040h:0085h first to determine the current font height. 
BUG: AMI 386 BIOS and AST Premier 386 BIOS will lock up the system if AL is not equal to the current video 
mode. 
Conflicts: None known. 
See Also: Function 03h 


INTERRUPT 10h - Function 02h 
SET CURSOR POSITION 


Purpose: Positions cursor on screen. 
Available on: All machines, Restrictions: none. 
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Registers at call: Return Registers: n/a. 
AH = 02h 
BH = page number 
0-3 in modes 2&3 
0-7 in modes 0&1 
0 in graphics modes 
DH = row (00h is top) 
DL = column (00h is left) 
Conflicts: None known. 
See Also: Functions 03h and 05h 


INTERRUPT 10h - Function 03h 
GET CURSOR POSITION AND SIZE 


Purpose: Reads current cursor position for a specific display page and the current cursor size. 


Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AH = 03h AX = 0000h (Phoenix BIOS) 
BH = page number CH = start scan line 

0-7 in modes 0 and 1 CL = end scan line 

0-3 in modes 2 and 3 DH = row (00h is top) 

0 in graphics modes DL = column (00h is left) 


Details: A separate cursor is maintained for each of up to 8 display pages. 
Conflicts: None known, 
See Also: Functions 01h and 02h 


INTERRUPT 10h - Function 04h 


READ LIGHT PEN POSITION 

Purpose: Determines location of light pen on screen. 

Available on: All machines. Restrictions: Meaningful only if light-pen hardware 
installed or if mouse is emulating light 
pen. 

Registers at call: Return Registers: 

AH = 04h AH = light pen trigger flag: 00h not down/triggered 

Olh down/triggered 


DH,DL = row,column of character light pen is on 

CH = pixel row (graphics modes 04h-06h) 

CX = pixel row (graphics modes with >200 rows) 

BX = pixel column 
Details: On a CGA, returned column numbers are always multiples of 2 (320-column modes) or 4 (640-column 
modes). Returned row numbers are only accurate to two lines. 
Conflicts: None known. 


INTERRUPT 10h - Function 05h 
SELECT ACTIVE DISPLAY PAGE 


Purpose: Selects which display page is to be active (displayed). 


Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: n/a. 
AH = 05h 


AL = new page number 

(00h to number of pages - 1) 

(see Function 00h) 
Conflicts: PCjr page register manipulation, Corona/Cordata BIOS v4.10+ Graphics Bitmap Buffer. 
See Also: Function 0Fh 
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INTERRUPT 10h - Function 05h, Subfunctions 80h to 83h 
MANIPULATE CRT/CPU PAGE REGISTERS 


Purpose: Controls video paging registers. 


Available on: PCjr only. Restrictions: none. 
Registers at call: Return Registers: 
AH = 05h 
AL = subfunction 
80h read CRT and CPU page registers BH = CRT page register 


BL=CPU page register 
81h set CPU page register 
BL = CPU page 
82h set CRT page register 
BH = CRT page 
83h set both CPU and CRT page registers 
BL = CPU pag 
BH = CRT page 
Details: The CPU page determines which 16K block of the first 128K ofphysical memory will be mapped at B800h 
by the hardware. The CRT pagedetermines the start address of the memory used by the video controller. 
Conflicts: Select Active Display Page. 


INTERRUPT 10h - Function 05h, Subfunctions 00h and OFh 


GRAPHICS BITMAP BUFFER 

Purpose: Establish location of graphics bitmap buffer. 

Available on: Corona/Cordata BIOS v4.10+ only. Restrictions: none. 
Registers at call: Return Registers: 
AH = 05h 


AL = 00h set address of graphics bitmap buffer 
(video modes 60h, 61h) 
BX = segment of buffer 

AL = OFh get address of graphics bitmap buffer DX = segment of graphics bitmap buffer 
(video modes 60h, 61h) 

Conflicts: Select Active Display Page. 


INTERRUPT 10h - Function 06h 


SCROLL UP WINDOW 

Purpose: Scrolls part or all of the screen up by the specified number of lines. 
Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: n/a. 
AH = 06h 


AL = number of lines by which to scroll up 
(00h = clear entire window) 
BH = attribute used to write blank lines at bottom of 
window 
CH,CL = row,column of window's upper left corner 
DH,DL = row,column of window's lower right 
corner 
Details: Affects only the currently active page (see Function 05h). 
Warning: Some implementations have a bug which destroys BP. 
Conflicts: None known. 
See Also: Functions 07h, 72h, and 73h 
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INTERRUPT 10h - Function 07h 


| SCROLL DOWN WINDOW 

| Purpose: Scrolls part or all of the screen down by the specified number of lines. 
Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: n/a. 

: AH =07h 


AL = number of lines by which to scroll down 
} (O0h=clear entire window) 
' BH = attribute used to write blank lines at top of 
window 
CH,CL = row,column of window's upper left corner 
DH,DL = row,column of window's lower right 
corner 
Details: Affects only the currently active page (see Function 05h). 
\ Warning: Some implementations have a bug which destroys BP. 
i Conflicts: None known. 
| See Also: Functions 06h, 72h, and 73h 


| INTERRUPT 10h - Function 08h 
READ CHARACTER AND ATTRIBUTE AT CURSOR POSITION 


Purpose: Determines text character and attribute at current cursor location. 
Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AH = 08h AH = attribute: 
BH = page number (00h to number of pages - 1) bit 7: blink 
(see Function 00h) bits 6-4: background color 
000 black 
| 001 blue 
010 green 
i O11 cyan 
| 100 red 
: 101 magenta 


110 brown 
111 white 
bits 3-0: foreground color 
0000 black 1000 dark gray 
0001 blue 1001 light blue 
0010 green 1010 light green 
OOl1 cyan 1011 light cyan 
0100 red 1100 light red 
0101 magenta 1101 light magenta 
} 0110 brown 1110 yellow 
O111 light gray 1111 white 
| AL = character 
| Details: For monochrome displays, a foreground of | with background 0 is underlined. 
| In graphics modes, the bitmap in the specified character cell must exactly match one of the bitmaps for the 
current mode's font, or the result is unpredictable. 
| The blink bit may be reprogrammed to enable intense background colors using Function 10h Subfunction 03h or 
by programming the CRT controller. 
Conflicts: None known. 
See Also: Function 09h, Function 10h Subfunction 03h 
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INTERRUPT 10h - Function 09h 
WRITE CHARACTER AND ATTRIBUTE AT CURSOR POSITION 


Purpose: Write specified character and attribute to display at current cursor location. 


Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: n/a. 
AH = 09h 


AL =character to display 
BH = page number (00h to number of pages - 1) 
(see Function 00h) 
BL = attribute (text mode) or color (graphics mode) 
if bit 7 set in graphics mode, character is 
xor'ed onto screen 
CX = number of times to write character 
Details: All characters are displayed, including CR, LF, and BS. 
The replication count in CX may produce an unpredictable result in graphics modes if it is greater than the 
number of positions remaining in the current row. 
Conflicts: None known. 
See Also: Functions 08h and OAh, INT 1Fh, INT 43h, INT 44h 


INTERRUPT 10h - Function 0Ah 
WRITE CHARACTER ONLY AT CURSOR POSITION 


Purpose: Write specified character to display at current cursor location, leaving the current attribute intact. 


Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: n/a. 
AH =0Ah 


AL = character to display 
BH = page number (00h to number of pages - 1) 
(see Function 00h) 
CX = number of times to write character 
Details: All characters are displayed, including CR, LF, and BS. 
The replication count in CX may produce an unpredictable result in graphics modes if it is greater than the 
number of positions remaining in the current row, 
Conflicts; None known, 
See Also: Functions 08h and 09h, INT 1Fh, INT 43h, INT 44h 


INTERRUPT 10h - Function 0Bh, Subfunction 00h 
SET BACKGROUND/BORDER COLOR 


Purpose: Sets background and border color value. 
Available on; All machines. Restrictions: none. 
Registers at call: Return Registers: n/a. 
AH =0Bh 
BH =00h 
BL = background/border color (border only in text 
modes) 
Conflicts: None known. 
See Also: Function 0Bh Subfunction 01h 


INTERRUPT 10h - Function OBh, Subfunction 01h 

SET COLOR PALETTE 

Purpose: Establish CGA graphics palettes. 

Available on: All machines. Restrictions: Applies to CGA and CGA-emulation 
only. 
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Registers at call: Return Registers: n/a. 
AH = 0BH 
BH =01h 
BL = palette ID 
00h background, green, red, and 
brown/yellow 
Oth background, cyan, magenta, and 
white 
Conflicts: None known. 
See Also: Function OBh Subfunction 00h 


INTERRUPT 10h - Function 0Ch 


WRITE GRAPHICS PIXEL 

Purpose: Write single pixel to graphics display. 

Available on: All machines. Restrictions: Valid only in graphics modes. 
Registers at call: Return Registers: n/a. 

AH = 0Ch 


BH = page number 
AL = pixel color (if bit 7 set, value is xor'ed onto 
screen) 
CX = column 
DX = row 
Details: BH is ignored if the current video mode supports only one page. 
Conflicts: None known, 
See Also: Functions 0Dh and 46h 


INTERRUPT 10h - Function 0Dh 
READ GRAPHICS PIXEL 


Purpose: Reads value of single pixel. 

Available on: All machines. Restrictions: Valid only in graphics modes. 
Registers at call: Return Registers: 

AH = 0Dh AL = pixel color 

BH = page number 

CX = column 

DX = row 

Details: BH is ignored if the current video mode supports only one page. 

Conflicts: None known. 

See Also: Functions 0Ch and 47h 


INTERRUPT 10h - Function 0Eh 


TELETYPE OUTPUT 

Purpose: Provides simple text-mode output technique. 

Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: n/a. 
AH = 0Eh 


AL = character to write 

BH = page number 

BL = foreground color (graphics modes only) 

Details: Characters 07h (BEL), 08h (BS), OAh (LF), and 0Dh (CR) are interpreted and perform the expected actions. 
IBM PC ROMs dated 4/24/81 and 10/19/81 require that BH be the same as the current active page (see function 
05h). 

Conflicts: None known. 

See Also: Functions 02h and OAh 
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INTERRUPT 10h - Function OFh 


GET CURRENT VIDEO MODE 

Purpose: Determine current video settings. 

Available on: All machines. Restrictions: none. 

Registers at call: Return Registers: 

AH = 0Fh AL = display mode (see Function 00h) 


AH = number of character columns 
BH = active page (see Function 05h) 
Details: If mode was set with bit 7 set ("no blanking"), the returned mode will also have bit 7 set. 
Conflicts: VUIMAGE Display Driver. 
See Also: Functions 00h and 05h 


INTERRUPT 10h - Function OFh, Subfunction 56h 
VUIMAGE DISPLAY DRIVER (v2.20 and below) 


Purpose: Special display driver for VUIMAGE graphics viewer program. 


Available on: All machines, Restrictions: Must have an appropriate VUIMAGE 
display driver loaded. 
Registers at call: Return Registers: 
AX = OF56h AX = 5649h 
BX = 4756h BX = 4443h 
CX = 4944h CX = 5647h 
DL = function: DH=0lh 
OIh installation check 
02h get first video mode's parameters AX = BIOS mode number 


BX = width in pixels 
CX = height in pixels 
DX = number of colors 
03h get next video mode's parameters as for DL=02h 
O4h display line (?) unknown. 
ES:DI -> record (see Table 5-3) 
other registers unknown. 
Conflicts: Standard video BIOS. 


Table 5-3, Format of record for DL=04h: 


Offset Size Description 

00h WORD row number 

02h WORD starting column??? 
04h WORD ending column??? 


INTERRUPT 10h - Function 10h 
BIOS Window Extension v1.1 - SET WINDOW COORDINATES 


Purpose: Establishes screen window area, 


Available on: All machines, Restrictions: Must have BIOS Window Extension 
TSR installed. 
Registers at call: Return Registers: 
AH = 10h AL & status 
CH,CL = row,column of upper left corner of 00h successful 
window Oth failed 
DH,DL = row,column of lower right corner of AH destroyed 
window 


Details: BWE is a TSR by John J. Seal published in the May 1986 issue of Dr. Dobb's Journal. 
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When a window has been set, all output via Function OEh is restricted to the specified window. 
Conflicts: Standard PCjr, EGA, MCGA, and VGA video BIOS functions. 
See Also: BIOS Window Extension Functions | 1h and 12h 


INTERRUPT 10h - Function 10h, Subfunction 00h 
SET SINGLE PALETTE REGISTER 


Purpose: Establish value for one palette register. 
Available on: PCjr, EGA, MCGA, VGA. Restrictions; On MCGA, only BX = 0712h is 
supported, 
Registers at call: Return Registers: n/a. 
AX = 1000h 
BL = palette register number (O0h-OFh) 
or attribute register number 
(undocumented) 
10h attribute mode control register 
(should let BIOS control this) 
11h overscan color register (see also 
Function 10h Subfunction 01h) 
12h color plane enable register (bits 
3-0 enable corresponding text 
attribute bit) 
13h horizontal PEL panning register 
14h color select register 
BH = color 
Details: Under UltraVision, the palette locking status (see function CDh, subfunction 01h) determines the outcome, 
Conflicts: BIOS Windows Extension. 
See Also: Function 10h Subfunctions 02h and 07h, Function CDh Subfunction 00h 


INTERRUPT 10h - Function 10h, Subfunction 01h 
SET BORDER (OVERSCAN) COLOR 


Purpose: Establish color for overscan register. 


Available on: PCjr, EGA, VGA. Restrictions: none. 
Registers at call: Return Registers: n/a. 
AX = 1001h 


BH = border color 

Details: Under UltraVision, the palette locking status (see function CDh, subfunction 01h) determines the outcome. 
BUG: The original IBM VGA BIOS incorrectly updates the parameter save area and places the border color at 

offset 11h of the palette table rather than offset 10h. 

Conflicts: BIOS Windows Extension. 

See Also: Function 10h Subfunctions 01h and 08h 


INTERRUPT 10h - Function 10h, Subfunction 02h 
SET ALL PALETTE REGISTERS 


Purpose: Set all palette registers with one command. 


Available on: PCjr, EGA, VGA. Restrictions: none. 
Registers at call: Return Registers: n/a. 
AX = 1002h 


ES:DX -> palette register list (Table 5-4) 

Details: Under UltraVision, the palette locking status (see function CDh, subfunction 01h) determines the outcome. 
Conflicts: BIOS Windows Extension. 

See Also: Function 10h Subfunctions 00h, 01h, and 09h 
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Table 5-4. Format of palette register list: 


Offset Size Description 
00h 16 Bytes colors for palette registers 00h through OFh 
10h BYTE border color 


INTERRUPT 10h - Function 10h, Subfunction 03h 
TOGGLE INTENSITY/BLINKING BIT 


Purpose: Toggle between blinking characters or bright background color. 


Available on: PCjr, PS, TANDY 1000, EGA, Restrictions: none. 
VGA. 
Registers at call: Return Registers: n/a. 
AX = 1003h 
BL = 00h enable background intensity 
Oth enable blink 


Details: Although there is no function to get the current status, bit 5 of 0040h:0065h indicates the state. 
Conflicts: BIOS Windows Extension. 
See Also: Function 08h 


INTERRUPT 10h - Function 10h, Subfunction 07h 
GET INDIVIDUAL PALETTE REGISTER 


Purpose: Read settings for single palette register. 


Available on: VGA-equipped systems. Restrictions: none. 
Registers at call: Return Registers: 
AX = 1007h BH = palette or attribute register value 


BL = palette or attribute (undocumented) register 

number (see subfunction 00h) 
Details: UltraVision v2+ supports this function even on color EGA systems in video modes 00h-03h, 10h, and 12h; 
direct programming of the palette registers will cause incorrect results because the EGA registers are write-only. To 
guard against older versions or unsupported video modes, programs which expect to use this function on EGA 
systems should set BH to FFh on entry. 
Conflicts: BIOS Windows Extension. 
See Also: Function 10h Subfunctions 00h and 09h 


INTERRUPT 10h - Function 10h, Subfunction O8h\v 
READ OVERSCAN (BORDER COLOR) REGISTER 


Purpose: Read setting for overscan register. 


Available on: VGA-equipped systems. Restrictions: none. 
Registers at call: Return Registers: 
AX = 1008h BH = value 


Details: UltraVision v2+ supports this function even on color EGA systems in video modes 00h-03h, 10h, and 12h; 
direct programming of the palette registers will cause incorrect results because the EGA registers are write-only. To 
guard against older versions or unsupported video modes, programs which expect to use this function on EGA 
systems should set BH to FFh on entry, 

Conflicts: BIOS Windows Extension. 

See Also: Function 10h Subfunction 01h 


INTERRUPT 10h - Function 10h, Subfunction 09h 
READ ALL PALETTE REGISTERS AND OVERSCAN REGISTER 


Purpose: Obtain values for all registers with single command. 
Available on: VGA-equipped systems. Restrictions: none. 
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Registers at call: Return Registers: n/a. 


AX = 1009h 

ES:DX -> 17-byte buffer (Table 5-5) 

Details: UltraVision v2+ supports this function even on color EGA systems in video modes 00h-03h, 10h, and 12h; 
direct programming of the palette registers will cause incorrect results because the EGA registers are write-only. To 
guard against older versions or unsupported video modes, programs which expect to use this function on EGA 
systems should set the ES:DX buffer to FFh before calling. 

Conflicts: BIOS Windows Extension. 

See Also: Function 10h Subfunctions 02h and 07h, Function CDh Subfunction 02h 


Table 5-5. Format of palette register list 


Offset Size Description 
00h 16 BYTEs colors for palette zegisters 00h through OFh 
10h BYTE border color 


INTERRUPT 10h - Function 10h, Subfunction 10h 
SET INDIVIDUAL DAC REGISTER 


Purpose: Set RGB values for a single Digital-Analog Converter register. 


Available on: VGA/MCGA-equipped systems. Restrictions: none. 
Registers at call: Return Registers: n/a. 
AX = 1010h 


BX = register number 

CH = new value for green (0-63) 

CL = new value for blue (0-63) 

DH = new value for red (0-63) 

Conflicts: BIOS Windows Extension. 

See Also: Function 10h Subfunctions 12h and 15h 


INTERRUPT 10h - Function 10h, Subfunction 12h 
SET BLOCK OF DAC REGISTERS 


Purpose: Set multiple RGB values into Digital-Analog Converter with single command. 


Available on: VGA/MCGA-equipped systems. Restrictions: none. 
Registers at call: Return Registers: n/a. 
AX = 1012h 


BX = starting color register 

CX = number of registers to set 

ES:DX -> table of 3*CX bytes where each 3 byte 
group represents one byte each of red, 
green and blue (0-63) 

Conflicts: BIOS Windows Extension. 

See Also: Function 10h Subfunctions 10h and 17h 


INTERRUPT 10h - Function 10h, Subfunction 13h 
SELECT VIDEO DAC COLOR PAGE 


Purpose: Select arrangement of DAC registers into blocks or the active block of registers. 


Available on: VGA-equipped systems. Restrictions: Not valid in mode 13h. 
Registers at call: Return Registers: n/a. 
AX = 1013h 


BL = 00h Select paging mode 
BH = 00h Select 4 blocks of 64 
BH = Oth Select 16 blocks of 16 





1 
| 
| 
| 
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BL = 01h Select Page 

BH = page number (00h to 03h) or (00h to OFh) 
Conflicts: BIOS Windows Extension. 
See Also: Function 10h Subfunction LAh 


INTERRUPT 10h - Function 10h, Subfunction 18h 
READ INDIVIDUAL DAC REGISTER 


Purpose: Determine RGB settings for specified DAC register. 


Available on: VGA/MCGA-equipped systems. Restrictions: none. 
Registers at call: Return Registers: 
AX = 1015h DH = red value 

BL = palette register number CH = green value 


CL = blue value 
Conflicts: BIOS Windows Extension. 
See Also: Function !0h Subfunctions 10h and 17h 


INTERRUPT 10h - Function 10h, Subfunction 17h 
READ BLOCK OF DAC REGISTERS 


Purpose: Determine RGB settings for specified block of DAC registers. 


Available on: VGA/MCGA-equipped systems. Restrictions: none. 
Registers at call: Return Registers: 
AX = 1017h buffer filled with red/green/blue triples. 


BX = starting palette register 

CX = number of palette registers to read 

ES:DX -> buffer (3 * CX bytes in size) (see also 
Function 10h Subfunction 12h) 

Conflicts: BIOS Windows Extension. 

See Also: Function 10h Subfunctions 12h and 15h 


INTERRUPT 10h - Function 10h, Subfunction 18h 
Undocumented - SET PEL MASK 


Purpose: Establishes new mask value. 


Available on: VGA/MCGA-equipped systems. Restrictions: none, 
Registers at call: Return Registers: n/a. 
AX = 1018h 


BL = new PEL value 
Conflicts: BIOS Windows Extension. 
See Also: Function 10h Subfunction 19h 


INTERRUPT 10h - Function 10h, Subfunction 19h 
Undocumented - READ PEL MASK 


Purpose: Determine current mask value. 


Available on: VGA/MCGA-equipped systems. Restrictions: none. 
Registers at call: Return Registers: 
AX = 1019h BL = value read 


Conflicts: BIOS Windows Extension. 
See Also: Function 10h Subfunction 18h 


INTERRUPT 10h - Function 10h, Subfunction 1Ah 
GET VIDEO DAC COLOR-PAGE STATE 


Purpose: Determine current setting of video paging mode and which block of color registers is active, 
Available on: VGA-equipped systems. Restrictions: none. 
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Registers at call: Return Registers: 
AX = 1O1Ah BL = paging mode 
00h four pages of 64 
Olh sixteen pages of 16 
BH = current page 
Conflicts: BIOS Windows Extension. 
See Also: Function 10h Subfunction 13h 


INTERRUPT 10h - Function 10h, Subfunction 1Bh 
PERFORM GRAY-SCALE SUMMING 


Purpose: Convert DAC registers from their current color to an equivalent gray-scale intensity level. 


Available on: VGA/MCGA-equipped systems. Restrictions: none. 
Registers at call: Return Registers: n/a. 
AX = 101Bh 


BX = starting palette register 

CX = number of registers to convert 
Conflicts: BIOS Windows Extension. 
See Also: Function 12h Subfunction 33h 


INTERRUPT 10h - Function 10h, Subfunction FOh 
Tseng ET-4000 BIOS - SET HiColor GRAPHICS MODE 


Purpose: Select an extended graphics mode. 


Available on: All machines. Restrictions: Tseng ET-4000 BIOS must be present, 
Registers at call: Return Registers: 

AX = 10FOh AX = 0000h if successful 

BL = video mode (see also Function 00h): other on error 


32768-color modes: 
13h = 320x200 
2Dh = 640x350 
2Eh = 640x480 
2Fh = 640x400 
30h = 800x600 
Details: The Tseng HiColor BIOS extensions are supported by: 


Diamond Computer Systems SpeedStar HiColor VGA 
Everex Systems HC VGA 

Focus Information Systems 2theMax 4000 

Cardinal Technologies VGA732 


Conflicts: BIOS Windows Extension. 
See Also: Function 10h Subfunction Flh 


INTERRUPT 10h - Function 10h, Subfunction Fih 
Tseng ET-4000 BIOS - GET DAC TYPE 


Purpose: Determine type of Digital-Analog Converter installed in system. 


Available on: All machines. Restrictions: Tseng ET-4000 BIOS must be present. 
Registers at call: Return Registers: 
AX = LOF1h BL = type of digital/analog converter: 

00h normal VGA DAC 


Oth Sierra SC1148x HiColor DAC 
else other HiColor DAC 
Conflicts: BIOS Windows Extension. 
See Also: Function 10h Subfunction FOh 
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INTERRUPT 10h - Function 11h 
BIOS Window Extension v1.1 - GET WINDOW COORDINATES 


Purpose: Determine limits of currently active window. 


Available on: All machines, Restrictions: Must have BIOS Window Extension 
TSR installed, 

Registers at call: Return Registers: 

AH = 11h CH,CL = row,column of upper left corner 


DH,DL = row,column of lower right corner 
Details: BWE is a TSR by John J. Seal published in the May 1986 issue of Dr. Dobb's Journal. 
Conflicts: Standard EGA/VGA video functions. 
See Also: BIOS Window Extension Functions 10h and 12h 


INTERRUPT 10h - Function 11h, Subfunctions 00h to 14h 
TEXT-MODE CHARACTER GENERATOR FUNCTIONS 


Purpose: Modifies text display fonts and sizes. 
Available on: Systems equipped with EGA, VGA, Restrictions: The following functions will cause a 
or MCGA video. mode set, completely resetting the video 
environment, but without clearing the 
video buffer. 
Registers at call: Return Registers: n/a. 
AH= Llh 
AL = 00h, 10h: load user-specified patterns 
ES:BP -> user table 
CX = count of patterns to store 
DX = character offset into map 2 block 
BL = block to load in map 2 
BH = number of bytes per character pattern 
line 
AL = 01h, 11h: load ROM monochrome patterns 
(8 by 14) 
BL = block to load 
AL = 02h, 12h: load ROM 8 by 8 double-dot 
patterns | 
BL = block to load | 
AL = 03h: set block specifier : 
BL= block specifier 
(EGA/MCGA) 
bits 0,1 = block selected by chars with 
attribute bit 3=0 
bits 2,3 = block selected by chars with 
attribute bit 3=1 





(VGA) 
bits 0,1,4 = block selected by attribute 
bit 3=0 
bits 2,3,5 = block selected by attribute 
bit 3=1 
AL = 04h, 14h: (VGA) load ROM 8x16 character 
set 


The routines called with AL=1xh are designed to be called only immediately after a mode set and are similar to the 
routines called with AL=Oxh, except that: 

Page 0 must be active. 

Bytes/character is recalculated. 


Max character rows is recalculated. 
CRT buffer length is recalculated. 
CRTC registers are reprogrammed as follows: 
RO9 = bytes/char-1 ; max scan line (mode 7 only) 
ROA = bytes/char-2 ; cursor start 
ROB =0 ; cursor end 
R12 = ((rows+1)*(bytes/char))-1 ; vertical display end 
R14=bytes/char —; underline loc (#*** BUG: should be | less ***) 
Conflicts: BIOS Window Extension GET WINDOW COORDINATES. 
See Also: Function CDh Subfunction 10h 


INTERRUPT 10h - Function 11h, Subfunctions 20h to 29h 
GRAPHICS-MODE CHARACTER GENERATOR FUNCTIONS 


Purpose: Establishes font and display size for text characters in graphics modes. 


Available on: Systems equipped with EGA, VGA, Restrictions: none. 
or MCGA video.. 
Registers at call: Return Registers: n/a. 
AH = Ith 
AL = 20h: set user 8 by 8 graphics characters 
(INT 1 Fh) 


ES:BP -> user table 
AL = 21h: set user graphics characters 
ES:BP -> user table 
CX = bytes per character 
BL = row specifier 
00h user set 
DL = number of rows 
Olh 14 rows 
02h 25 rows 
03h 43 rows 
AL = 22h: ROM 8 by 14 set 
BL = row specifier 
00h user set 
DL = number of rows 
Oth 14 rows 
02h 25 rows 
03h 43 rows 
AL = 23h; ROM 8 by 8 double dot 
BL = row specifier 
00h user set 
DL = number of rows 
Oth 14 rows 
02h 25 rows 
03h 43 rows 
AL = 24h: load 8x16 graphics characters 
(VGA/MCGA) 
BL = row specifier 
00h user set 
DL = number of rows 
Oth 14 rows 
02h 25 rows 
03h 43 rows 
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AL = 29h: load 8x16 graphics characters 
(Compaq Systempro) 
BL = row specifier 
00h user set 
DL = number of rows 
Oih 14 rows 
02h 25 rows 
03h 43 rows 
Details: These functions are meant to be called only after a mode set. 
UltraVision v2+ sets INT 43h to the appropriate font for AL=22h, 23h, 24h, and 29h. 
Conflicts: BIOS Window Extension GET WINDOW COORDINATES. 
See Also: INT 1Fh, INT 43h 


INTERRUPT 10h - Function 11h, Subfunction 30h 


GET FONT INFORMATION 
Purpose: Returns pointer to specified font table. 
Available on: Systems equipped with EGA, VGA, Restrictions: none, 
or MCGA video. 

Registers at call: Return Registers: 
AX = 1130h ES:BP = specified pointer 
BH = pointer specifier CX = bytes/character 

00h INT 1Fh pointer DL = character rows on screen 


Oih INT 43h pointer 
02h ROM 8 by 14 character font pointer 
03h ROM 8 by 8 double dot font pointer 
04h ROM 8 by 8 DD font (top half) 
05h ROM alpha alternate (9 by 14) 
pointer 
06h ROM 8 by 16 font (VGA,MCGA 
only) 
07h ROM alternate 9 by 16 font (VGA 
only) 
11h (UltraVision v2+) 8x20 font (VGA) 
or 8x19 font (autosync EGA) 
12h (UltraVision v2+) 8x10 font (VGA) 
or 8x11 font (autosync EGA) 
Details: For UltraVision v2+, the 9xN alternate fonts follow the corresponding 8xN font at ES:BP-+256N. 
Conflicts: BIOS Window Extension GET WINDOW COORDINATES. 
See Also: Function 11h Subfunctions 00h and 20h, INT 1Fh, INT 43h 


INTERRUPT 10h - Function 12h 
BIOS Window Extension v1.1 - GET BLANKING ATTRIBUTE 


Purpose: Determine attribute which will be used on blanked lines when scrolling. 


Available on: All machines, Restrictions: Must have BIOS Window Extension 
TSR installed. 

Registers at call; Return Registers: 

AH = 12h BH = attribute 


Details: BWE is a TSR by John J. Seal published in the May 1986 issue of Dr. Dobb's Journal. 
Conflicts; Normal EGA/VGA video functions. 
See Also: BIOS Window Extension Functions 10h and 11h 
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INTERRUPT 10h - Function 12h, Subfunction 10h 
ALTERNATE FUNCTION SELECT - GET EGA INFO 


Purpose: Determine video system characteristics. 


Available on: Systems equipped with EGA, VGA, Restrictions: none. 
or MCGA video. 
Registers at call: Return Registers: 
AH = 12h BH = 00h color mode in effect (1/O port 3Dxh) 
BL= 10h O1h mono mode in effect (I/O port 3Bxh) 


BL = 00h 64k bytes memory installed 
Olh 128k bytes memory installed 
02h 192k bytes memory installed 
03h 256k bytes memory installed 
CH = feature bits 
CL = switch settings 
Conflicts: BIOS Window Extension GET BLANKING ATTRIBUTE, 


INTERRUPT 10h - Function 12h, Subfunction 20h 
ALTERNATE FUNCTION SELECT - ALTERNATE PRTSC 


Purpose: Selects alternate PrtScr routine. 


Available on: Systems equipped with EGA, VGA, Restrictions: none. 

or MCGA video. 
Registers at call: Return Registers: n/a. 
AH = 12h 


BL = 20h select alternate print screen routine 
Details: Installs a PrtSc routine from the video card's BIOS to replace the default PrtSc handler from the ROM 


BIOS, which usually does not understand screen heights other than 25 lines, Some adapters disable print-screen 
instead of enhancing it. 

Conflicts: BIOS Window Extension GET BLANKING ATTRIBUTE. 

See Also: INT 05h (chapter 2) 


INTERRUPT 10h - Function 12h, Subfunction 30h 
ALTERNATE FUNCTION SELECT - SELECT VERTICAL RESOLUTION 
Purpose: Sets number of scanlines; permits switching between 25- and 28-character modes, or 43- and 50-character 
modes, when used following INT 10h Function 11h. 
Available on: VGA-equipped systems. Restrictions: none. 
Registers at call: Return Registers: 
AH = 12h AL = 12h if function supported 
BL = 30h 
AL & vertical resolution 
00h 200 scan lines 
01h 350 scan lines 
02h 400 scan lines 
See Also: Character Generator Functions under Function [1h 
Conflicts: BIOS Window Extension GET BLANKING ATTRIBUTE. 


INTERRUPT 10h - Function 12h, Subfunction 31h 


ALTERNATE FUNCTION SELECT - PALETTE LOADING 


Purpose: Control loading of default palette. 
Available on: VGA/MCGA-equipped systems. Restrictions: none. 
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Registers at call: Return Registers: 
AH = 12h AL = 12h if function supported. 
BL=3ih 


AL = 00h enable default palette loading 
Oth disable default palette loading 
Conflicts: BIOS Window Extension GET BLANKING ATTRIBUTE. 


INTERRUPT 10h - Function 12h, Subfunction 32h 
ALTERNATE FUNCTION SELECT - VIDEO ADDRESSING 


Purpose: Control CPU access to video memory. 


Available on: VGA/MCGA-equipped systems. Restrictions: none. 

Registers at call: Return Registers: 

AH = 12h AL = 12h if function supported. 
BL = 32h 


AL = 00h enable video addressing 
Oth disable video addressing 
Conflicts: BIOS Window Extension GET BLANKING ATTRIBUTE, 


INTERRUPT 10h - Function 12h, Subfunction 33h 
ALTERNATE FUNCTION SELECT - GRAY-SCALE SUMMING 


Purpose: Controls usability of gray-scale summing function. 


Available on: VGA/MCGA-equipped systems. Restrictions: none. 

Registers at call: Return Registers: 

AH = 12h AL = 12h if function supported. 
BL = 33h 


AL = 00h enable gray scale summing 

Olh disable gray scale summing 
Conflicts: BIOS Window Extension GET BLANKING ATTRIBUTE. 
See Also: Function 10h Subfunction 1Bh 


INTERRUPT 10h - Function 12h, Subfunction 34h 
ALTERNATE FUNCTION SELECT - CURSOR EMULATION | 


Purpose: Enable/disable cursor emulation. 


Available on: VGA-equipped systems. Restrictions: none. 

Registers at call: Return Registers: 

AH = 12h AL = 12h if function supported. 
BL = 34h 


AL = 00h enable alphanumeric cursor emulation 
Oth disable alphanumeric cursor 
emulation 
Conflicts: BIOS Window Extension GET BLANKING ATTRIBUTE. 


INTERRUPT 10h - Function 12h, Subfunction 35h 
ALTERNATE FUNCTION SELECT - DISPLAY-SWITCH INTERFACE 


Purpose: Switches between two video displays. 


Available on: VGA/MCGA-equipped systems. Restrictions: none. 

Registers at call: Return Registers: 

AH = 12h AL = 12h if function supported. 
BL=35h 


AL = 00h initial adapter video off 
Oth initial planar video on 
02h switch active video off 
03h switch inactive video on 
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80h (undocumented) set system board 
video active flag 
ES:DX -> buffer 
(128 byte save area if AL = 0, 2 or 3) 
Conflicts: BIOS Window Extension GET BLANKING ATTRIBUTE. 


INTERRUPT 10h - Function 12h, Subfunction 36h 
ALTERNATE FUNCTION SELECT - VIDEO REFRESH CONTROL 


Purpose: Enable/disable video refresh. 


Available on: VGA/MCGA-equipped systems. Restrictions: none. 
Registers at call: Return Registers: 
AH = 12h AL = 12h if function supported 
BL = 36h 
AL = 00h enable refresh 
O1h disable refresh 


Details: Display is blanked when video refresh is disabled. 
Conflicts: BIOS Window Extension GET BLANKING ATTRIBUTE, 


INTERRUPT 10h - Function 12h, Subfunction 55h 
ALTERNATE FUNCTION SELECT - ENHANCED FEATURES 


Purpose: Provides advanced features. 


Available on: ATI, Tatung, Taxan video cards Restrictions: none. 
only. 

Registers at call: Return Registers: n/a. 

AH = 12h 

BH=55h 


BL = subfunction: 
00h disabled enhanced features 
Olh enable enhanced features 
02h get status AL = status flags 
bit 3: set if enhanced features enabled 
bits 7-5 monitor type 
000 PS/2 mono 
001 PS/2 color 
010 multi-sync 
O11 Taxan 650 25kHz 
100 RGB 
101 mono 
110 EGA 
111 Compaq internal 
03h disable register trapping 
(CGA emulation) 
04h enable register trapping 
OSh program mode described by table 


at ES:BP (Table 5-6) 
OGh get mode table (Table 5-6) ES:BP -> table suitable for mode AL (and 


AL = video mode subfunction BL=05h) 
BP = FFFFh on error 
Conflicts: BIOS Window Extension GET BLANKING ATTRIBUTE. 
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Table 5-6. Format of ATI VGA Wonder video mode table: 


Offset Size Description 

00h BYTE number of columns 

Olh BYTE maximum row (number of rows - 1) 
02h BYTE scan lines per row 

03h WORD video buffer size in bytes 

05h 4 Bytes values for Sequencer registers 1-4 

09h BYTE value for Miscellaneous Output register 
OAh 23 BYTEs values for CRTC registers OOh-18h: 


00h horizontal total size (chars) 

O1h horizontal displayed (chars) 
02h horizontal syne position (chars) 
03h horizontal sync width (chars) 
04h vertical total size (char rows) 
OSh vertical total adjust (scan lines) 
OGh vertical displayed (char rows) 
O7h vertical sync position (char rows) 
08h interlace mode 

09h max scan par in row 

OAh cursor start scan line 

OBh cursor end scan line 

OCh screen memory start (high) 

ODh screen memory start (low) 

OEh cursor address (high) 

OFh cursor address (low) 








10h light pen (high) 
[1h light pen (low) 
23h 20BYTEs default palette (values for AttributeController registers 00h-13h) 
37h 9BYTEs values for Graphics Controller registers 0Oh-08h 
INTERRUPT 10h - Function 13h 
WRITE STRING 
Purpose: Displays string on CRT. 
Available on: All AT and later systems, plus all Restrictions: none. 
systems with EGA or later video 
card, 
Registers at call: Return Registers: n/a. 
AH = 13h 


AL = write mode: 
bit 0: update cursor position after writing 
1: string contains alternating characters 
and attributes 
BH = page number 
BL = attribute if string contains only characters 
CX = number of characters in string 
DH,DL = row,column at which to start writing 
ES:BP -> string to write 
Details: Recognizes CR, LF, BS, and bell. 
Conflicts: None known. 
See Also: Functions 09h and 0Ah 


INTERRUPT 10h - Function 14h, Subfunction 00h 
LOAD USER-SPECIFIED LCD CHARACTER FONT 


Purpose: Changes character font. 





Available on: IBM Convertible, Compaq Portable 
386. 

Registers at call: 

AX = 1400h 

ES:DI -> character font 

BH = number of bytes per character: 08h or 10h 
(Compaq) 

BL = 00h load main font (block 0) 
O1h load alternate font (block 1) 

CX = number of characters to store 

DX = character offset into RAM font area 

Conflicts: None known. 

See Also: Function 11h, Function 14h Subfunction O1h 


INTERRUPT 10h - Function 14h, Subfunction 01h 
LOAD SYSTEM ROM DEFAULT LCD CHARACTER FONT 


Purpose: Loads default character font, 
Available on: IBM Convertible, Compaq Portable 
386. 
Registers at call: 
AX = 1401h 
BL = 00h load main font (block 0) 
Oth load alternate font (block 1) 
Conflicts: None known. 
See Also: Function I 1h, Function 14h Subfunction 00h 


INTERRUPT 10h - Function 14h, Subfunction 02h 
SET MAPPING OF LCD HIGH INTENSITY ATTRIBUTES 


Purpose: Modifies display of high-intensity attribute. 
Available on: IBM Convertible, Compaq Portable 
386. 
Registers at call: 
AX = 1402h 
BL = 00h ignore high intensity attribute 
Oth map high intensity to underscore 
02h map high intensity to reverse video 
03h map high intensity to selected 
alternate font 
BOh half intensity (Compaq) 
Bh toggle active intensity bit 
interpretation (Compaq Portable 386) 


INTERRUPT 10h - Function 15h 

GET PHYSICAL DISPLAY PARAMETERS 
Purpose: Obtains physical display information. 
Available on: IBM Convertible. 

Registers at call: 

AH = 15h 
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Restrictions: none. 


Return Registers: n/a. 


Restrictions: none. 


Return Registers: n/a. 


Restrictions: none. 


Return Registers: n/a. 


Restrictions: none. 
Return Registers: 
AX = alternate display adapter type: 
0000h none 
5140h LCD 
5153h CGA 
5151h mono 
ES:DI -> parameter table (see Table 5-7) 
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Conflicts: Set Superimpose Mode (Sperry PC). 
See Also: Function 1Bh 


Table 5-7. Format of display parameter table: 


Offset Size Description 

00h WORD monitor model number 

02h WORD vertical pixels per meter 

04h WORD horizontal pixels per meter 

06h WORD total vertical pixels 

08h WORD total horizontal pixels 

OAh WORD horizontal pixel separation in micrometers 

0Ch WORD vertical pixel separation in micrometers 

INTERRUPT 10h - Function 15h 

SET SUPERIMPOSE MODE 

Purpose: Permit simultaneous text and graphics display. 

Available on: Sperry PC only. Restrictions: none. 
Registers at call: Return Registers: n/a. 
AH = 15h 


AL = superimpose mode 

00h show graphics screen 

O1h show text screen 

02h text superimposed on graphics screen 
Conflicts: Get Physical Display Parameters, 


INTERRUPT 10h - Function 1Ah 


DISPLAY COMBINATION 

Purpose: Determine video card and monitor characteristics. 

Available on: VGA/MCGA-equipped systems. Restrictions: none. 

Registers at call: Return Registers: 

AH=1Ah AL = 1Ah if function was supported 

AL = 00h read display combination code BL = active display code (see below) 
OIh set display combination code BH = alternate display code 


BL = active display code (see Table 5-8) 
BH = alternate display code 
Conflicts; None known. 


Table 5-8. Values for display combination codes 





Value Display Combination 

00h no display 

Olh monochrome adapter with monochrome display 
02h CGA with color display 

03h reserved 

04h EGA with color display 

05 EGA with monochrome display 

06 PGA with color display 

O7h VGA with monochrome analog display 
08) VGA with color analog display 

09 reserved 

OAh MCGA with digital color display 

OBh MCGA with monochrome analog display 
0Ch MCGA with color analog display 

FFh unknown display type 


INTERRUPT 10h - Function 1Bh 
FUNCTIONALITY/STATE INFORMATION 


Purpose: Obtain full details of video setup. 


Available on: VGA/MCGA-equipped systems. 


Registers at call: 

AH = 1Bh 

BX = implementation type 
0000h return functionality/state 

information 

ES:DI -> 64 byte buffer for state information 
(see Table 5-9) 

Conflicts: None known. 

See Also: Function 15h 
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Restrictions: none. 

Return Registers: 

AL = 1Bh if function supported 

ES:DI buffer filled with state information 


Table 5-9. Format of state information 


Offset Size Description 
00h DWORD address of static functionality table (see Table 5-10) 
04h BYTE video mode in effect 
05h WORD number of columns 
07h WORD length of regen buffer in bytes 
09h WORD starting address of regen buffer 
OBh WORD cursor position for page 0 
0Dh WORD cursor position for page | 
OFh WORD cursor position for page 2 
Ith WORD cursor position for page 3 
13h WORD cursor position for page 4 
15h WORD cursor position for page 5 
17h WORD cursor position for page 6 
19h WORD cursor position for page 7 
1Bh WORD cursor type 
1Dh BYTE active display page 
1Eh WORD CRTC port address 
20h BYTE current setting of register (378) 
21h BYTE current setting of register (379) 
22h BYTE number of rows 
23h WORD bytes/character 
25h BYTE DCC of active display 
26h BYTE DCC of alternate display 
27h WORD number of colors supported in current mode 
29h WORD number of pages supported in current mode 
2Ah BYTE number of scan lines active: 
0 = 200 
1=350 
2=400 
3 = 480 
2Bh BYTE primary character block 
2Ch BYTE secondary character block 
2Dh BYTE miscellaneous flags: 


bit 0 all modes on all displays on 
1 gray summing on 
2 monochrome display attached 
3 default palette loading disabled 
4 cursor emulation enabled 
5 0 = intensity; | = blinking 


6 PS/2 P70 plasma display (without 9-dot widefont) active 


7 reserved 
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Table 5-9. Format of state information (continued) 


Offset 
2Eh 
3ih 


32h 


33h 


Size 
3 BYTEs 
BYTE 


BYTE 


Description 
reserved 
video memory available: 
00h = 64K, 
Olh = 128K, 
02h = 192K, 
03h = 256K 
save pointer state flags: 
bit 0 512 character set active 
1 dynamic save area present 
2 alpha font override active 
3 graphics font override active 
4 palette override active 
5 DCC override active 
6 reserved 
7 reserved 


13 BYTEs reserved 


Table 5-10. Format of Static Functionality Table 


Offset 
00h 


Oth 
02h 
03h 
07h 
08h 


09h 
OAh 


OBh 


0Ch 


Size 
BYTE 


BYTE 
BYTE 
4 BYTEs 
BYTE 
BYTE 


BYTE 
BYTE 


BYTE 


WORD 


Description 

modes supported #1: 

bit 0 to bit 7 = 1 modes 0, 1, 2, 3, 4, 5, 6 supported 
modes supported #2: 


bit 0 to bit 7 = 1 modes 8, 9, OAh, OBh, OCh, ODh, OEh, OFh supported 


modes supported #3: 
bit 0 to bit 3 = 1 modes 10h, 11h, 12h, 13h supported 
bit 4 to bit 7 reserved 
reserved 
scan lines supported: 
bit 0 to bit 2 = 1 if scan lines 200,350,400 supported 
total number of character blocks available in text modes 
maximum number of active character blocks in text modes 
miscellaneous function flags #1: 
bit 0 all modes on all displays function supported 
1 gray summing function supported 
2 character font loading function supported 
3 default palette loading enable/disablesupported 
4 cursor emulation function supported 
5 EGA palette present 
6 color palette present 
7 color paging function supported 
miscellaneous function flags #2: 
bit 0 light pen supported 
1 save/restore state function 1Ch supported 
2 intensity blinking function supported 
3 Display Combination Code supported 
4-7 reserved 
reserved 
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Table 5-10. Format of Static Functionality Table (continued) 


Offset Size Description 
OEh BYTE save pointer function flags: 
bit 0 512 character set supported 
| dynamic save area supported 
2 alpha font override supported 
3 graphics font override supported 
4 palette override supported 
5 DCC extension supported 
6 reserved 
7 reserved 
OFh BYTE reserved 


INTERRUPT 10h - Function 1Ch 
SAVE/RESTORE VIDEO STATE 


Purpose: Saves or restores video state. 


Available on: VGA-equipped systems. Restrictions: none. 

Registers at call: Return Registers: 

AH = [Ch AL = [Ch if function supported. 

AL = 00h return state buffer size BX = number of 64-byte blocks needed 


Oh save video state 
ES:BX -> buffer for video state 
02h restore video state 
ES:BX -> buffer containing 
previously saved state 
CX = requested states: 
bit 0 video hardware 
1 BIOS data areas 
2 color registers and DAC state 
3-15 reserved 
Conflicts: None known, 


INTERRUPT 10h - Function 30h, Subfunction 00h 
LOCATE 3270PC CONFIGURATION TABLE 


Purpose: Determines whether 3270PC program is active and if so, returns pointer to configuration table. 


Available on: 3270PC only. Restrictions: none. 

Registers at call: Return Registers: 

AX = 3000h CX:DX -> 3270PC configuration table (Table 5-11) 
CX = 0000h CX:DX = 0000h:0000h if 3270PC Control Program 
DX = 0000h not active 


Conflicts: None known. 


Table 5-11. Format of 3270 PC configuration table 


Offset Size Description 
00h BYTE aspect ratio X 
Olh BYTE aspect ratio Y 
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Table 5-11. Format of 3270 PC configuration table (continued) 


Offset 
02h 


Size 
BYTE 


03h BYTE 
04h BYTE 


reserved 


05h BYTE 
06h BYTE 


Teserved 


Description 
monitor type: 


00h = 5151 (mono) or 5272 (color) 

Olh = 3295 

02h = 5151 or 5272 with XGA (27?) graphics adapter 
03h = 5279 with 3270PC G adapter 

04h = 5379 model CO1 with 3270PC GX adapter 

OSh = 5379 model MO1 with 3270PC GX adapter 
07h = non-3270PC with 3270 Workstation Program 
FFh = 3270PC Control Program not loaded 


adapter ID: 


00h = 5151/5272 adapter 
04h = 5151/5272 with XGA adapter 
30h = 3295 or 3270PC G/GX adapter 


function flags 1: 


bit 1: 720x350 eight-color graphics 


07h BYTE 


2: 360x350 four-color graphics 
3: 720x350 two-color graphics 
4: CGA color graphics 

5: color text, 4 pages 

6: color text, 1 page 

7; mono text, 1 page 


function flags 2: 


bit 6: GPI graphics supported 


08h WORD 
OAh 10 BYTEs reserved 


segment address of Control Program Level table (see Table 5-12) 


Table 5-12. Format of Control Program Level table: 


Offset Size Description 
00h WORD program version: — 02xxh = 3270PC Control Program v2.xx 
03xxh = 3270PC Control Program v3.xx 
04xxh = 3270 Workstation Program v1,xx 
02h BYTE Control Program ID (00h) 
03h 27BYTEs Control Program Descriptor ("IBM 3270 PC CONTROL PROGRAM") 


INTERRUPT 10h - Function 40h 


SET GRAPHICS MODE 


Purpose: Places system into graphics mode. 
Available on: Hercules-equipped systems. 
Registers at call: 

AH = 40h 

Conflicts: None known. 

See Also: Function 41h 


INTERRUPT 10h - Function 41h 
SET TEXT MODE 


Purpose: Places system into text mode. 
Available on: Hercules-equipped systems. 
Registers at call: 

AH = 41h 

Conflicts: None known. 

See Also: Function 40h 


Restrictions: Must have GRAFIX software installed, 
Return Registers: n/a. 


Restrictions: Must have GRAFIX software installed. 
Return Registers: n/a. 


INTERRUPT 10h - Function 42h 
CLEAR CURRENT PAGE 


Purpose: Erases all data on current display page. 
Available on: Hercules-equipped systems. 
Registers at call: 

AH = 42h 

Conflicts: None known. 

See Also: Function 45h 


INTERRUPT 10h - Function 43h 
SELECT DRAWING PAGE 


Purpose: Specifies page to be drawn on. 
Available on: Hercules-equipped systems. 
Registers at call: 

AH = 43h 

AL = page number (0 or 1) 

Conflicts: None known. 

See Also: Functions 44h and 45h 


INTERRUPT 10h - Function 44h 
SELECT DRAWING FUNCTION 


Purpose: Specifies function to be used when drawing. 


Available on: Hercules-equipped systems. 
Registers at call: 


AH = 44h 
AL= 00h clear pixels 
Olh set pixels 


02h invert pixels 
Conflicts: None known. 
See Also: Functions 44h, 46h, 4Ch, and 4Dh 


INTERRUPT 10h - Function 45h 
SELECT PAGE TO DISPLAY 

Purpose: Specifies which page to display. 
Available on: Hercules-equipped systems. 
Registers at call: 

AH =45h 

AL = page number (0,1) 

Conflicts: None known. 

See Also: Functions 42h and 43h 


INTERRUPT 10h - Function 46h 
DRAW ONE PIXEL 


Purpose: Draws one pixel at specified location using operati 


Available on: Hercules-equipped systems. 
Registers at call: 

AH = 46h 

DI = x (0-720) 

BP = y (0-347) 
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Restrictions: Must have GRAFIX software installed. 
Return Registers: n/a. 


Restrictions: Must have GRAFIX software installed. 
Return Registers: n/a. 


Restrictions: Must have GRAFIX software installed. 
Return Registers: n/a. 


Restrictions: Must have GRAFIX software installed. 
Return Registers: n/a. 


on and page already set by other functions. 


Restrictions: Must have GRAFIX software installed. 
Return Registers: n/a. 


Details: Function 44h determines operation and function 43h which page to use for drawing. 


Conflicts: None known. 
See Also: Functions 0Ch, 47h,49h, 4Ch, and 4Dh 
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INTERRUPT 10h - Function 47h 
FIND PIXEL VALUE 


Purpose: Reads one pixel at specified location from page already set by other functions. 


Available on: Hercules-equipped systems. 
Registers at call: 

AH = 47h 

DI = x (0-720) 

BP = y (0-347) 

Details: Function 43h specifies which page is used. 
Conflicts: None known, 

See Also: Functions 0Dh and 46h 


INTERRUPT 10h - Function 48h 
MOVE TO POINT 


Purpose: Moves current position to specified location. 


Available on: Hercules-equipped systems. 
Registers at call: 

AH =48h 

DI= x (0-720) 

BP = y (0-347) 

Conflicts: None known, 

See Also: Function 49h 


INTERRUPT 10h - Function 49h 
DRAW TO POINT 


Restrictions: Must have GRAFIX software installed. 
Return Registers: 

AL = 00h pixel clear 

AL = 01h pixel set 


Restrictions: Must have GRAFIX software installed, 
Return Registers: n/a. 


Purpose: Draws line from current position to specified location and sets that location as new current position, 


Available on: Hercules-equipped systems. 
Registers at call: 

AH = 49h 

DI = x (0-720) 

BP = y (0-347) 


Restrictions: Must have GRAFIX software installed, 
Return Registers: n/a. 


Details: Prior call to function 48h or 49h specify first point, 44h specifies operation and 43h specifies page on which 


to draw. 
Conflicts: None known, 
See Also: Functions 43h, 44h, 48h, 4Ch, and 4Dh 


INTERRUPT 10h - Function 4Ah 
BLOCK FILL 


Purpose: Draws a solid rectangle. 
Available on: Hercules-equipped systems. 
Registers at call: 

AH =4Ah 

DI = x coordinate of lower left corner 

BP = y coordinate of lower left corner 

BX = height in pixels 

CX = width in pixels 

Conflicts: None known. 

See Also: Function 4Eh 


INTERRUPT 10h - Function 4Bh 
DISPLAY CHARACTER 


Purpose: Displays character at specified location, 


Restrictions: Must have GRAFIX software installed. 
Return Registers: n/a. 
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Available on: Hercules-equipped systems. Restrictions: Must have GRAFIX software installed. 
Registers at call: Return Registers: n/a. 

AH =48Bh 

AL = character to display 

DI = x (0-720) 

BP = y (0-347) 

Details: Unlike the other BIOS character functions, character position is specified in pixels rather than rows and 
columns. 

Conflicts: FRIEZE v7+ API. 

See Also: Functions 09h and OAh 


INTERRUPT 10h - Function 4Bh 
FRIEZE v7+ API 


Purpose: Provides interface between Frieze graphics printing system and application programs. 
Available on: All machines. 
Restrictions: Frieze software (part of ZSoft's 
Paintbrush systems) must be installed. 


Registers at call: Return Registers: 
AH =4Bh AX = status: 
CL = function 00h successful 
00h reserved Olh user aborted printout with ESC 
O1h load window 02h reserved 
ES:BX -> ASCIZ filename from O3h file read error 
which to read 04h file write error 
02h save window O5h file not found 
ES:BX -> ASCIIZ filename to which 06h invalid header (not an image or wrong screen 
to write mode) 
O7h set window size 07h file close error 
ES:BX -> foure WORD structure O8h disk error 
with Xmin, Ymin, Xmax, Ymax 09h printer error 
09h set patterns OAh invalid function 
ES:BX -> 16-BYTE vector of OBh can't create file 
screen-> printer color- OCh wrong video mode 
correspondences 
OAh get patterns 
ES:BX -> 16-BYTE buffer for color 
correspondences 
OBh set mode 
AL = mode 


OFh get window 
ES:BX -> four- WORD buffer for 
Xmin, Ymin, Xmax, Ymax 
10h set print options 
ES:BX -> printer options in same 
format as FRIEZE cmdline 
14h get version AH = major version (00h if FRIEZE version before 7) 
AL = minor version 
15h set parameters 
ES:BX -> parameter table 
(Table 5-13) 
16h get parameters 
ES:BX -> buffer for parameter table 
(Table 5-13) 


| 
| 
i 
| 
i 
| 
| 
| 
| 
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17h get printer resolution 
ES:BX -> 12-WORD table for six 
horizontal/vertical resol pairs 
18h reserved (v8.0 only) 


Conflicts: Hercules GRAFIX Display Character function. 


Table 5-13. Format of Frieze parameter table 


02h use horizontal/vertical resolution for output resolution 


Offset Size Description 
00h WORD top margin (1/100 inch) 
02h WORD left margin (1/100 inch) 
04h WORD horizontal size (1/100 inch) 
06h WORD vertical size (1/100 inch) 
08h WORD quality/draft mode: 
00h draft mode 
O1h quality mode 
OAh WORD printer horizontal resolution (dots per inch) 
0Ch WORD printer vertical resolution (dots per inch) 
OEh WORD reserved (FFFFh) 


Details: Any field which should remain unchanged may be filled with FFFFh. 


INTERRUPT 10h - Function 4Ch 
DRAW ARC 


Purpose: Draws specified arc on current page. 
Available on: Hercules-equipped systems, 
Registers at call: 

AH =4Ch 

AL = quadrant (1 = upper right, 2 = upper left, etc) 
DI = x coordinate of center 

BP = y coordinate of center 

BX = radius 

Conflicts: None known. 

See Also: Functions 49h and 4Dh 


INTERRUPT 10h - Function 4Dh 
DRAW CIRCLE 


Purpose: Draws specified circle on current page. 
Available on: Hercules-equipped systems. 
Registers at call: 

AH = 4Dh 

DI = x of center 

BP = y of center 

BX = radius 

Conflicts: None known. 

See Also: Functions 49h and 4Ch 


INTERRUPT 10h - Function 4Eh 
FILL AREA 


Purpose: Fills any convex polygonal area, 
Available on: Hercules-equipped systems. 


Restrictions: Must have GRAFIX software installed. 
Return Registers: n/a. 


Restrictions: Must have GRAFIX software installed. 
Return Registers: n/a. 


Restrictions: Must have GRAFIX software installed. 
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Registers at call: Return Registers: n/a. 
AH=4Eh 

DI = x coordinate of an interior point 

BP = y coordinate of an interior point 

Details: The first fill makes the figure solid, the second erases it. 

Conflicts: None known. 

See Also: Function 4Ah 


INTERRUPT 10h - Function 4Fh, Subfunction 00h 
VESA SuperVGA BIOS - GET SuperVGA INFORMATION 


Purpose: Determine whether SuperVGA BIOS is present and if so, obtain information about its setup. 


Available on: All machines. Restrictions: VESA SuperVGA BIOS must be 
present. 
Registers at call: Return Registers: 
AX = 4F00h AL = 4Fh function supported 
ES:DI -> 256-byte buffer for SuperVGA AH & status 
information (Table 5-14) 00h successful 
Oth failed 


Conflicts: None known. 
See Also: Function 4Fh Subfunction Oh 


Table 5-14. Format of SuperVGA information: 


Offset Size Description 

00h 4BYTEs _ signature ('VESA’) 

04h WORD VESA version number 

06h DWORD pointer to OEM name 

OAh 4BYTEs capabilities 

OEh DWORD _ pointer to list of supported VESA and OEM video modes 
12h 238 BYTEs reserved 


INTERRUPT 10h - Function 4Fh, Subfunction Oth 
GET VESA SuperVGA MODE INFORMATION 


Purpose: Determine operating mode of SuperVGA BIOS. 


Available on: Systems equipped with VESA Restrictions: none. 
SuperVGA BIOS. 
Registers at call: Return Registers: 
AX = 4FO0lh = SuperVGA video mode AL = 4Fh function supported 
ES:DI -> 256-byte buffer mode information AH = status: 
(Table 5-15) 00h successful 
Olh failed 


Conflicts: None known, 
See Also: Function 4Fh Subfunctions 00h and 02h 


Table 5-15. Format of mode information 


Offset Size Description 
00h WORD mode attributes: 
bit 0: mode supported 
bit 1: optional information available 
bit 2: BIOS output supported 
bit 3: set if color, clear if monochrome 
bit 4: set if graphics mode, clear if text mode 
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Table 5-15. Format of mode information (continued) 


Description 
window A attributes: 
bit 0: exists 
bit 1: readable 
bit 2: writable 
bits 3-7 reserved 
window B attributes (as for window A) 
window granularity (smallest KB increment by which window can be moved) 
window size in K 
start segment of window A 
start segment of window B 
-> FAR window positioning function (equivalent to Function 4Fh Subfunction 05h) 
bytes per scan line 


---remainder is optional for VESA modes, needed for OEM modes--» 





Offset Size 
02! BYTE 
03h BYTE 
04h WORD 
06! WORD 
08h WORD 
OAh WORD 
0Ch DWORD 
10) WORD 
12) WORD 
14h WORD 
16h BYTE 
17 BYTE 
18. BYTE 
19h BYTE 
1Ah BYTE 
1Bh BYTE 
ich BYTE 


width in pixels 

height in pixels 

width of character cell in pixels 
height if character cell in pixels 
number of memory planes 
number of bits per pixel 
number of banks 

memory model type 

size of bank in K 


INTERRUPT 10h - Function 4Fh, Subfunction 02h 
SET VESA SuperVGA VIDEO MODE 


Purpose: Select a video display mode defined by the VESA committee. 


Available on: Systems equipped with VESA Restrictions: none. 
SuperVGA BIOS. 

Registers at call: Return Registers: 

AX = 4F02h AL = 4Fh function supported 

BX = mode: AH = status 
100h 640x400x256 00h successful ' 
101h 640x480x256 O1h failed / 
102h —800x600x16 : 
103h —800x600x256 
104h —1024x768x16 i 
105h — 1024x768x256 1 
106h —1280x1024x16 : 
107h — 1280x1024x256 
108h 80x60 text 
109h = 132x25 text 
10Ah 132x43 text 
1OBh = 132x50 text 
10Ch 132x60 text 


bit 15 set means don't clear video memory 
Details: Video modes less than 100h are defined to be identical to the non-VESA video mode set with INT 10h 
Function 00h and are thus vendor-specific, 
Conflicts: None known. 
See Also: Function 4Fh Subfunctions 01h and 03h 


INTERRUPT 10h - Function 4Fh, Subfunction 03h 
GET CURRENT VESA SuperVGA VIDEO MODE 


Purpose: Determines current video mode. 





| 
| 


Available on: Systems equipped with VESA 
SuperVGA BIOS. 

Registers at call: 

AX = 4F03h 


Restrictions: none. 


Return Registers: 


AL = 4Fh function supported 


AH & status: 
00h successful 
Olh failed 


BX = video 
100h 
10th 
102h 
103h 
104h 
105h 
106h 
107h 
108h 
109h 
10Ah 
10Bh 
10Ch 


mode: 
640x400x256 
640x480x256 
800x600x16 
800x600x256 
1024x768x16 
1024x768x256 
1280x1024x16 
1280x 1024x256 
80x60 text 
132x25 text 
132x43 text 
132x50 text 
132x60 text 
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Details: Video modes less than 100h are defined to be identical to the non-VESA video mode set with INT 10h 


Function 00h and are thus vendor-specific. 
Conflicts: None known. 
See Also: Function 4Fh Subfunction 02h 


INTERRUPT 10h - Function 4Fh, Subfunction 04h 
SAVE/RESTORE VESA SuperVGA VIDEO STATE 


Purpose: Saves or restores specified states of video BIOS. 


Available on: Systems equipped with VESA 
SuperVGA BIOS. 

Registers at call: 

AX = 4F04h 

DL = subfunction: 


00h get state buffer size 
Olh save video states 
ES:BX -> buffer 
02h restore video states 
ES:BX -> buffer 
CX = flags for states to save/restore 
bit 0: video hardware state 
bit 1: video BIOS data state 
bit 2; video DAC state 
bit 3: SuperVGA state 
Conflicts: None known. 


INTERRUPT 10h - Function 4Fh, Subfunction 05h 
VESA SuperVGA CPU VIDEO MEMORY CONTROL 


Purpose: Controls access to video RAM. 


Available on: Systems equipped with VESA 
SuperVGA BIOS. 


Restrictions: none. 


Return Registers: 


AL = 4Fh function supported 


AH = status 


00h successful 
Olh failed 


BX = number of 64-byte blocks needed 


Restrictions: none. 
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Registers at call: Return Registers: 
AX = 4F05h AL =4Fh function supported 
BH = subfunction: AH = status: 
00h select video memory window 00h successful 
DX = window address in video Oth failed 
memory (in granularity units) 
Oth get video memory window DX = window address in video memory (in 


granularity units) 
BL = window number: 


00h window A 
Oih window B 
Conflicts: None known, 
See Also: Function 4Fh Subfunctions 06h and 07h 
INTERRUPT 10h - Function 4Fh, Subfunction 06h 
GET/SET SuperVGA LOGICAL SCAN LINE LENGTH 
Purpose: Reads current logical line length, or sets new value. 
Available on: Systems equipped with VESA Restrictions: none. 
SuperVGA BIOS v1.1 or higher. 
Registers at call: Return Registers: 
AX = 4F06h AL = 4Fh if function supported 
BL = 00h set scan line length AH = status: 
CX = desired width in pixels 00h successful 
BL = Olh get scan line length Oth failed 


BX = bytes per scan line 

CX = number of pixels per scan line 

DX = maximum number of scan lines 
Details: If the desired width is not achievable, the next larger width will be set. The scan line may be wider than the 
visible area of the screen. This function is valid in text modes, provided that values are multiplied by the character 
cell width/height. 
Conflicts: None known, 
See Also: Function 4Fh Subfunctions Oth, 0Sh, and 07h 


INTERRUPT 10h - Function 4Fh, Subfunction 07h 
GET/SET SuperVGA DISPLAY START 


Purpose: Reads or sets pixel address of leftmost pixel in scan line. 


Available on: Systems equipped with VESA Restrictions: none. 
SuperVGA BIOS v1.1 or higher. 
Registers at call: Return Registers: 
AX = 4F07h AL = 4Fh if function supported 
BH = 00h (reserved) AH & status: 
BL = 00h set display start 00h successful 
CX = leftmost displayed pixel in scan line Olh failed 
DX = first displayed scan line 
BL = Olh get display start BH = 00h 


CX = leftmost displayed pixel in scan line 

DX = first displayed scan line 
Details: This function is valid in text modes, provided that values aremultiplied by the character cell width/height. 
Conflicts: None known. 
See Also: Function 4Fh Subfunctions 01h, 05h, and 06h 
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INTERRUPT 10h - Function 55h, Subfunction 55h 
ATI EGA/VGA Wonder Super Switch - INSTALLATION CHECK 


Purpose: Determine whether Super Switch program is present. 


Available on: Systems equipped with ATI EGA or 
VGA Wonder video card. 

Registers at call: 

AX = 5555h 


Restrictions: Super Switch (SMS.COM) or 
VCONFIG must be installed. 
Return Registers: 
AX = AAAAh if installed 
BX:CX -> unknown data or routine in 
SMS.COM resident portion 
-> data area in VCONFIG (Table 5-16) 


Details: Super Switch (SMS.COM) is a video mode switch program supplied with the ATI EGA Wonder. It also 


maps video mode 08h to 27h or 23h. 
Conflicts: None known. 
See Also: INT 10h Function 00h 


Table 5-16. Format of data area: 


Offset Size Description 

00h DWORD _ original INT 09h vector 

04h DWORD _ original INT 10h vector 

08h DWORD original INT 1Ch vector 

0Ch WORD screen saver state, O=off, [=on 
OEh WORD blanking interval in clock ticks 


INTERRUPT 10h - Function 6Ah, Subfunction 00h 


Direct Graphics Interface Standard - INQUIRE AVAILABLE DEVICES 
Purpose: To determine what DGIS-compatible devices, if any, are present, 


Available on: Systems with DGIS software 
installed. 

Registers at call: 

AX = 6A00h 

BX = 0000h 

CX = 0000h 

DX = buffer length (may be 0) 

ES:DI -> buffer 


Restrictions: none. 


Return Registers: 
BX = number of bytes stored in buffer 
CX = bytes required for all descriptions (0 if no DGIS) 


Details: Buffer contains descriptions and addresses of DGIS-compatible display(s) and printer(s). 


Conflicts: None known. 
See Also: Function 6Ah Subfunction 02h 


INTERRUPT 10h - Function 6Ah, Subfunction 01h 


DGIS - REDIRECT CHARACTER OUTPUT 


Purpose: Changes destination of all output sent via INT 10h. 


Available on: Systems with DGIS software 
installed. 

Registers at call: 

AX = 6A01h 

CX = 0000h 

ES:DI = address of device to get INT 10h output 

Conflicts: None known. 

See Also: Function 6Ah Subfunction 02h 


Restrictions: none. 


Return Registers: 
CX = 0000h output could not be redirected 
else INT 10h output now routed to requested 
display 
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INTERRUPT 10h - Function 6Ah, Subfunction 02h 
DGIS - INQUIRE INT 10h OUTPUT DEVICE 


Purpose: Determine currently active destination for INT 10h output. 


Available on: Systems with DGIS software Restrictions: none, 
installed. 
Registers at call: Return Registers: 
AX = 6A02h ES:DI = 0000h:0000h if current display is non-DGIS 
ES:DI = 0000h:0000h else address of the current DGIS INT 10h display 


Conflicts: None known. 
See Also: Function 6Ah Subfunctions 00h and 01h 


INTERRUPT 10h - Function 6Fh, Subfunction 00h 
Video7/VEGA VGA INSTALLATION CHECK 


Purpose: To determine whether Video? VGA, or VEGA VGA, BIOS extensions are present. 


Available on: Systems equipped with Video7 VGA Restrictions: none. 
or VEGA VGA card. 
Registers at call: Return Registers: 
AX = 6F00h BX = 5637h ('V7') indicates Video? VGA/VEGA 


VGA extensions are present 
Conflicts: None known. 


INTERRUPT 10h - Function 6Fh, Subfunction 01h 
Video7/VEGA VGA - GET MONITOR INFO 


Purpose: Obtains video and CRT information. 


Available on: Systems equipped with Video? VGA Restrictions: none. 
or VEGA VGA card. 
Registers at call: Return Registers: 
AX = 6F01h AL = monitor type code (VEGA VGA only) 


AH = status register information: 
bit 0 = display enable 
0 = display enabled 
1 = vertical or horizontal retrace in progress 
bit 1 = light pen flip flop set 
bit 2 = light pen switch activated 
bit 3 = vertical sync 
bit 4 = monitor resolution 
0 = high resolution (>200 lines) 
1 = low resolution (<=200 lines) 
bit 5 = display type 
0 =color 
1 = monochrome 
bits 6, 7 = diagnostic bits 
Details: Bits 0-3 are the same as the EGA/VGA status register bits 0-3. 
Conflicts: None known. 


INTERRUPT 10h - Function 6Fh, Subfunction 04h 
GET VIDEO MODE AND SCREEN RESOLUTION 


Purpose: Returns current video mode and display size. 
Available on: Systems equipped with Video? VGA Restrictions: none. 
or VEGA VGA card. 
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Registers at call: Return Registers: 
AX = 6F04h AL = current video mode (see Function 6Fh 
Subfunction 05h) 


BX = horizontal columns (text) or pixels (graphics) 
CX = vertical columns (text) or pixels (graphics) 
Conflicts: None known. 
See Also: Function 6Fh Subfunction 05h 


INTERRUPT 10h - Function 6Fh, Subfunction 05h 


SET VIDEO MODE 
Purpose: Select a nonstandard Video7-specific display mode. 
Available on: Systems equipped with Video? VGA Restrictions: none. 
or VEGA VGA card. 
Registers at call: Return Registers: n/a. 
AX = 6F05h 


BL = mode (see Table 5-17) 

Conflicts: None known. 

See Also: Function 00h, Function 00h Subfunctions 70h and 7Eh, Function 6Fh Subfunction 04h 
Table 5-17. Values for Video7-specific video modes 


TEXT/ = TEXT PIXEL PIXEL DISP_ SCRN 
GRPH — RESOL BOX RESOLTN COLORS PAGE ADDR SYSTEM 


00h-13h = standard IBM modes (see Function 00h) 





40h = T 80x43 8x8 Video7/VEGA VGA 

4ih=T 132x25 8x14 Video7/VEGA VGA 

42h=T 132x43 8x8 Video7/VEGA VGA 

43h =T 80x60 8x8 Video7/VEGA VGA 

44h =T 100x60 8x8 Video7/VEGA VGA 

45h =T 132x28 8x8 Video7/VEGA VGA 

60h =G 752x410 16 Video? VGA, VEGA VGA 

6lh=G 720x540 16 Video? VGA, VEGA VGA 
=G 720x540 «16 Northgate 

62h=G 800x600 16 Video7 VGA,VEGA Ext EGA 

63h =G 1024x768 2 Video? VGA 

64h =G 1024x768 4 Video? VGA 

65h =G 1024x768 16 VideoT VGA, VEGA Ext EGA 

66h =G 640x400 256 Video? VGA, VEGA Ext VGA 
=G 640x400 256 Northgate 

67h=G 640x480 256 Video? VGA,VEGA Ext VGA 

68h =G 720x540 256 Video7 VGA, VEGA Ext VGA 

69h=G 800x600 256 Video? VGA, VEGA Ext VGA 

Wh=G 752x410 l6gray Video? VGA, VEGA VGA 

Th=G 720x540 16gray VideoT VGA, VEGA VGA 
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Table 5-17. Values for Video7-specific video modes (continued) 


TEXT/ = TEXT PIXEL PIXEL DISP_  SCRN 

GRPH  RESOL BOX RESOLTN COLORS PAGE ADDR SYSTEM 
T2h=G 800x600 l6gray Video7 VGA 
Bh=G 1024x768 2gray Video7 VGA 
74h=G 1024x768 4gray Video7 VGA 
7h=G 1024x768 l6gray Video7 VGA 
Teh=G 640x400 256gray Video7 VGA 
Tih=G 640x480 256gray Video7 VGA 
Bh=G 720x540 256gray Video7 VGA 
7T9h=G 800x600 256gray (future) 
INTERRUPT 10h - Function 6Fh, Subfunction 06h 
SELECT AUTOSWITCH MODE 
Purpose: Sets type of video-mode autoswitching. 
Available on: Systems equipped with Video7 VGA Restrictions: none. 

or VEGA VGA card. 

Registers at call: Return Registers: n/a, 
AX = 6F06h 


BL = Autoswitch mode select: 
00h select EGA/VGA- only modes 
O1h select Autoswitched VGA/ EGA/ 
CGA/ MGA modes 
02h select 'bootup' CGA/MGA modes 
BH = enable/disable (00h enable, 
O1h = disable selection) 
Conflicts: None known. 


INTERRUPT 10h - Function 6Fh, Subfunction 07h 
GET VIDEO MEMORY CONFIGURATION 


Purpose: Determine size and type of video RAM present. 


Available on: Systems equipped with Video? VGA Restrictions: none. 
or VEGA VGA card, 
Registers at call: Return Registers: 
AX = 6FO7h AL = 6Fh 
AH = bits 0-6 = number of 256K blocks of video 
memory 


bit 7 = DRAM/VRAM (0: DRAM, 1: VRAM) 
BH = chip revision (SR8F) (S/C Chip in VEGA VGA) 
BL = chip revision (SR8E) (G/A Chip in VEGA VGA) 
CX = 0000h 
Conflicts: None known. 
See Also: Function 12h Subfunction 10h 


INTERRUPT 10h - Function 70h 
GET ADDRESS OF VIDEO RAM 


Purpose: Determine where the three color planes of video RAM are located, 
Available on: Tandy 2000 only. Restrictions: none. 
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Registers at call: Return Registers: 
AH = 70h AX:BX -> word containing green plane's offset 
AX:CX -> word containing green plane's segment 
AX:DX -> word containing segment of red (offset 0) 
and blue (offset 4000) planes 
Conflicts: Everex Extended Video BIOS 
See Also: Function 71h 


INTERRUPT 10h - Function 7000h, Subfunction 0000h 
Everex Extended Video BIOS - RETURN EMULATION STATUS 


Purpose: Determine video operating setup. 
Available on: Systems equipped with Everex Restrictions: none. 
Extended Video BIOS. 
Registers at call: Return Registers: 
AX =7000h CL = monitor type: 
BX = 0000h 00h mono 
Olh CGA 
02h EGA 
03h digital multifrequency 
04h IBM PS/2 
05h IBM 8514 
06h SuperVGA 
O7h analog multifrequency 
O8h super multifrequency 
CH = feature bits: 
bits 7,6: 00 = 256K memory 
01 = 512K memory 
10 = 1024K 
11 = 2048K memory 
bit 5; special oscillator present 
bit 4: VGA protect enabled 
bit 0: 6845 emulation 
DX = video board info: 
bits 4-15: board ID model 
bits 0-3: board ID revision 
DI = BCD BIOS version number 


Conflicts: Get Video RAM Address (Tandy 1000). 


INTERRUPT 10h - Function 7000h, Subfunction 0004h 
GET PAGING FUNCTION POINTER FOR CURRENT MODE 


Purpose: Obtains pointer to function selecting which page of video memory is to be mapped into the CPU's address 


space. 
Available on: Systems equipped with Everex Restrictions: none. 
Extended Video BIOS. 
Registers at call: Return Registers: 
AX = 7000h ES:DI -> FAR paging function (call with DL = page to 
BX = 0004h set) 


Details: The word preceding ES:DI is the length of the function in bytes, and the last byte of the function is a FAR 
return instruction. 

Conflicts: Get Video RAM Address (Tandy 1000). 

See Also: Function 7000h Subfunctions 0000h and 0005h 
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INTERRUPT 10h - Function 7000h, Subfunction 0005h 
Everex Extended Video BIOS - GET SUPPORTED MODE INFO 


Purpose: Determine information about supported video mode(s). 


Available on: Systems equipped with Everex Restrictions: none. 
Extended Video BIOS. 

Registers at call: Return Registers: 
AX = 7000h CL = total number of modes fitting criteria 
BX =0005h CH = size of each info record 
CL = maximum number of modes for which to get 

info 
CH = mode type to get info for: 

00h all modes 


Olh monochrome text modes 
02h color text modes 
03h four-color CGA graphics modes 
04h two-color CGA graphics modes 
05h 16-color graphics modes 
06h 256-color graphics modes 
DL = monitor type to get info for 
ES:DI -> buffer for mode info (Table 5-1 8) 
Conflicts: Get Video RAM Address (Tandy 1000). 
See Also: Function 7000h Subfunctions 0000h and 0004h 


Table 5-18. Format of mode information record: 


Offset Size Description 

00h BYTE mode number (bit 7 set if extended mode) 
Oth BYTE mode type (see above) 

02h BYTE info bits: 


bits 7,6 reserved i 
5 monochrome mode I 
4 interlaced display i 
3 requires special oscillator 
2,1 memory required: 


00 = 256K 
01 =512K 
10 = 1024K 
11 = 2048K 
0 reserved 

03h BYTE font height 

04h BYTE text columns on screen 

05h BYTE text rows on screen 

06h WORD number of scan lines 

08h BYTE color information: 


bits 7-4 reserved 
3-0 bits per pixel 


INTERRUPT 10h - Function 71h 


GET ADDRESS OF INCRAM 

Purpose: Determine where INCRAM is located. 

Available on: Tandy 2000 only. Restrictions: none. 

Registers at call: Return Registers: 

AH = 71h AX:BX -> word containing INCRAM segment 


AX:CX -> word containing INCRAM offset 





Conflicts: None known. 
See Also: Function 70h 


INTERRUPT 10h - Function 72h 
RIGHT SCROLL 


Purpose: Scroll part of all of the display to the right. 

Available on: Tandy 2000 only. 

Registers at call: 

AH = 72h 

AL = number of columns by which to shift 
00h = blank scroll area 

BH = atttribute for blanked columns at left 

CH = topmost row in scroll area 

CL = leftmost column in scroll area 

DH = bottommost row in scroll area 

DL = rightmost column in scroll area 

Conflicts: None known. 

See Also: Functions 06h, 07h, and 73h 


INTERRUPT 10h - Function 73h 
LEFT SCROLL 


Purpose: Scroll part or all of the display to the left, 

Available on: Tandy 2000 only. 

Registers at call: 

AH = 73h 

AL = number of columns by which to shift 
00h = blank scroll area 

BH = atttribute for blanked columns at right 

CH = topmost row in scroll area 

CL = leftmost column in scroll area 

DH = bottommost row in scroll area 

DL = rightmost column in scroll area 

Conflicts: None known. 

See Also: Functions 06h, 07h, and 72h 


INTERRUPT 10h - Function 80h 
Undocumented - SET unknown HANDLER 


Purpose: unknown. 

Available on: All machines. 

Registers at call: 

AH = 80h 

DX = 4456h (‘DV’) 

ES:DI -> FAR subroutine to be called on 
unknown event. 
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Restrictions: none. 
Return Registers: n/a 


Restrictions: none. 
Return Registers: n/a 


Restrictions: DESQview 2.0x must be operating. 

Return Registers: 

DS = segment of DESQview data structure for video 
buffer 


Details: This function is probably meant for internal use only, due to the magic value required in DX. The subroutine 
seems to be called when the DESQview menu is accessed; on entry, AL = 03h or 04h, 


Conflicts: None known. 


INTERRUPT 10h - Function 81h 
Undocumented - GET unknown DATA STRUCTURE 


Purpose: Return the address of an internal data structure related to the program's DESQview window. 


Available on: Ali machines. 


Restrictions: DESQview 2.0x must be operating. 
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Registers at call: Return Registers: 
AH = 81h ES = segment of DESQview data structure for video 
DX = 4456h (‘DV') buffer 


BYTE ES:[0] = current window number in DV 2.0x 
Details: This function is probably meant for internal use only, due to the magic value required in DX. 
Conflicts: None known. 
See Also: Function 82h 


INTERRUPT 10h - Function 82h 
Undocumented - GET CURRENT WINDOW INFO 


Purpose: unknown. 


Available on: All machines. Restrictions: DESQview 2.0x must be operating. 
Registers at call: Return Registers: 

AH = 82h DS = segment in DESQview for data 

DX = 4456h (‘DV') structure in DV 2.00, 


BYTE DS:[0] = window number 
WORD DS:[1] = segment of other data structure 
WORD DS:[3] = segment of window's object 
handle 
ES = segment of DESQview data structure for video 
buffer 
AL = current window number 
AH = unknown. 
BL = direct screen writes: 
00h program does not do direct writes 
O1h program does direct writes, so shadow buffer 
not usable 
BH = unknown, 
CL = current video mode 


CH = unknown. 
Details: This function is probably meant for internal use only, due to the magic value required in DX. 
Conflicts; None known. 
See Also: Function 81h 


INTERRUPT 10h - Function BFh, Subfunction 00h 
SELECT EXTERNAL MONITOR 


Purpose: Switches to external monitor, 

Available on: Compaq Portable only. Restrictions: none. 

Registers at call: Return Registers: n/a. 

AX = BFO0Oh 

Details: All registers are preserved and the internal monitor is blanked, The external monitor becomes the active 
monitor, 

Conflicts: None known. 

See Also: Function BFh Subfunction 01h 


INTERRUPT 10h - Function BFh, Subfunction 01h 
SELECT INTERNAL MONITOR 


Purpose: Switches to internal monitor. 

Available on: Compaq Portable only. Restrictions: none. 
Registers at call: Return Registers: n/a. 
AX=BFOIh 
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Details: Ail registers are preserved and the external monitor is blanked. The internal monitor becomes the active 


monitor. 
Conflicts: None known. 
See Also: Function BFh Subfunction 00h 


INTERRUPT 10h - Function BFh, Subfunction 02h 
SET MASTER MODE OF CURRENT VIDEO CONTROLLER 
Purpose: Selects emulation mode for video controller. 
Available on: Compaq Portable only. 
Registers at call: 
AX = BFO2h 
BH = master mode: 

04h CGA 

05h EGA 

07h MDA 
Conflicts: None known. 
See Also: Function BFh Subfunction 03h 


INTERRUPT 10h - Function BFh, Subfunction 03h 
GET VIDEO ENVIRONMENT 


Purpose: Determine video operating environment in effect. 


Available on: Compaq Portable and Systempro 
only. 

Registers at call: 

AX = BFO3h 

BX = 0000h 


Restrictions: none. 
Return Registers: n/a. 


Restrictions: none. 


Return Registers: 
BH = active monitor: 
00h = external 
Olh = internal 
BL = master mode: 
00h = switchable VDU not present 
04h = CGA 
05h = EGA 
07h =MDA 
08h = switchable LCD controller present 
CH = 00h (reserved) 
CL = switchable VDU mode supported: 
bit 0 = CGA supported 
bits 1,2 = reserved (1) 
bit 3 = MDA supported 
bits 4-7 = reserved (1) 
DH = internal monitor type: 
00h = none 
Olh = Dual-mode monitor 
02h = 5153 RGB monitor 
03h = Compaq Color monitor 
04h = 640x400 flat panel 
07h = LCD VGA 
DL = external monitor type: 
00h = none 
O1h = dual-mode monitor 
02h = 5153 RGB monitor 
03h = Compaq Color monitor 
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Conflicts: None known. 


04h = 640x400 flat panel 
05h = VGC monochrome 


06h = VGC color 


See Also: Function 1 Ah, Function BFh Subfunctions 00h-02h 


INTERRUPT 10h - Function BFh, Subfunction 04h 


SET MODE SWITCH DELAY 


Purpose: Control delay when switching video modes. 


Available on: Compaq Portable only. 


Registers at call: 

AX = BF04h 

BH = 00h enable delay 
Olh disable delay 

Conflicts: None known. 

See Also: Function BF 


INTERRUPT 10h - Function BFh, Subfunction 05h 


Subfunction 05h 


ENABLE/DISABLE DISPLAY 


Purpose: Turn video off/on. 
Available on: Compaq Systempro only. 





Registers at call: 
AX = BFOSh 
BH = 00h video off 

Oh video on 
Conflicts: None known. 
See Also: Function BFh 


INTERRUPT 10h - Function BFh, Subfunction 06h 


Subfunction 04h 


READ GRAY SCALE TABLE 


Purpose: Obtain value of specified gray scale table entry. 


Available on: Compaq SLT/286 only. 


Registers at call: 
AX = BFOGh 


CL = address to be read from gray scale table 


Conflicts: None known, 


Restrictions: none. 
Return Registers: n/a. 


Restrictions: none. 
Return Registers: n/a. 


Restrictions: none. 
Return Registers: 


AL = bit 3-0 - Value read from gray scale table 
CL = address to be read from gray scale table 


See Also: Function 12h Subfunction 33h, Function BFh Subfunction 07h 


INTERRUPT 10h - Function BFh, Subfunction 07h 


WRITE GRAY SCALE TABLE 


Purpose: Set value of specified gray scale table entry. 


Available on: Compaq SLT/286 only. 


Registers at call: 
AX = BFO7h 


CH = value to write to gray scale table 


CL = address to be written to gray scale table 


Conflicts: None known. 
See Also: Function BFh 


INTERRUPT 10h - Function BFh, Subfunction 08h 


Subfunction 06h 


WRITE COLOR MIX REGISTERS 


Purpose: Establish color weights for gray scale conversion. 





Available on: Compaq SLT/286 only. 


Restrictions: none. 
Return Registers: n/a. 


Restrictions: none. 
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Registers at call: Return Registers: n/a. 
AX = BFO8h 
CH = bits 7-4 - Green weight 
bits 3-0 - Blue weight 
CL = bits 7-4 - unused 
bits 3-0 - Red weight 
Conflicts: None known. 


INTERRUPT 10h - Function CCh, Subfunction 00h 


GET ULTRAVISION STATUS 

Purpose: Determines whether UltraVision is active, and if so, details of its setup. 

Available on: EGA and VGA systems. Restrictions: UltraVision, a video-BIOS extender 
program from Personics, Inc., must be 
loaded. 

Registers at call: Return Registers: 

AX =CCO00h CX = ABCDh 

SI = 0000h (if checking version) AL = Ultravision extensions 

00h enabled 
FFh disabled 


AH = card designator 
BX:00F0h -> palette values (for compatibility with 
NEWFONT) 
DX = support for high resolution modes 
00h not active 
Olh active 
SI = UltraVision version number (v1.2 or higher): high 
byte=major, low byte=minor 
unchanged for versions below 1.2 
Conflicts: None known. 
See Also: Function CCh Subfunctions 01h and 02h 


INTERRUPT 10h - Function CCh, Subfunction 01h 
DISABLE ULTRAVISION EXTENSIONS 


Purpose: Returns video action to non-UltraVision operation without unloading program. 


Available on; EGA and VGA systems. Restrictions: UltraVision, a video-BIOS extender 
program from Personics, Inc., must be 
loaded. 

Registers at call: Return Registers: n/a 

AX =CCOlh 


Details: Subsequent BIOS calls will be passed through to previous handler. Should be followed immediately by 
mode set to restore normal EGA/VGA state. 


Conflicts: None known. 
See Also: Function CCh Subfunction 02h 


INTERRUPT 10h - Function CCh, Subfunction 02h 
ENABLE ULTRAVISION EXTENSIONS 


Purpose: Allow UltraVision to modify video operations. 


Available on: EGA and VGA systems. Restrictions: UltraVision, a video-BIOS extender 
program from Personics, Inc., must be 
loaded. 


Registers at call: Return Registers: n/a 


AX = CC02h 
Details: Should be followed immediately by mode set to restore previous UltraVision state. 
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Conflicts: None known. 
See Also: Function CCh Subfunction Oth 


INTERRUPT 10h - Function CDh, Subfunction 00h 
LOAD ULTRAVISION PALETTE 


Purpose: Change color palette. 


Available on: Color EGA and VGA systems, Restrictions: UltraVision, a video-BIOS extender 
program from Personics, Inc., must be 
loaded. 

Registers at call: Return Registers: n/a. 

AX =CD00h 


CL = palette table number (01h-07h for vi.x, 
O1h-OFh for v2+) 
DS:DX -> 16-byte palette register list 
(colors for registers O0h-OFh) 
Details: If palette locking is in effect for the current mode, the new colors will be displayed immediately; otherwise, 
the system reverts to the default palette. Palette table 0 is reserved for the default palette and cannot be set. 
UltraVision always sets the border color to black, 
Conflicts: None known. 
See Also: Function CDh Subfunctions 01h and 02h 


INTERRUPT 10h - Function CDh, Subfunction 01h 
SET PALETTE LOCKING STATUS 


Purpose: Controls palette locking action. 


Available on: Color EGA and VGA systems. Restrictions: UltraVision, a video-BIOS extender 
program from Personics, Inc., must be 
loaded. 

Registers at call: Return Registers: n/a. 

AX =CDOlh 

CL = palette locking value: 

00h none 


Olh text modes only (02h,03h) 
FFh all modes (all standard color text and 
graphics modes) 
Details: Intended for video modes with 16 or fewer colors, 
Conflicts: None known. 
See Also: Function 10h Subfunctions 00h and 02h, Function CDh Subfunction 03h 


INTERRUPT 10h - Function CDh, Subfunction 02h 


GET ULTRAVISION PALETTE 
Purpose: Determine current palette, 
Available on: EGA and VGA systems. Restrictions: UltraVision, a video-BIOS extender 
program from Personics, Inc., must be 
loaded. 


Registers at call: 
AX = CD02h 
Return Registers: 
CL = palette table number 
DS:DX -> 17-byte palette register list (Table 5-19) 
DS:SI -> current font names table (Tables 5-20, 5-21)) 
Details: Only the font names are valid on monochrome EGA systems, 
Conflicts: None known. 
See Also: Function 10h Subfunction 09h, Function CDh Subfunction 00h 
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Table 5-19. Format of palette register list: 


Offset Size Description 
00h 16 BYTEs colors for palette registers 00h through OFh 
10h BYTE border color 


Table 5-20. Format of current font names table (v2+): 


Offset Size Generic EGA Generic VGA Super VGA 
00h 8BYTEs N/A F19 font F20 font 
08h 8BYTEs F14 font Fi4font F14 font 
10h 8BYTEs N/A Fll font F10 font 
18h SBYTEs  F8 font F8 font F8 font 


Table 5-21. Format of current font names table (v1.x): 





Offset Size Description 
00h 8BYTEs FI9/F14 font 
08h 8BYTEs FII/F8 font 


INTERRUPT 10h - Function CDh, Subfunction 03h 

GET PALETTE LOCKING STATUS 

Purpose: Read current status of palette locking feature, 

Available on: Color EGA and VGA systems. Restrictions: UltraVision, a video-BIOS extender 
program from Personics, Inc., must be 
loaded. 

Registers at call: Return Registers: 

AX = CD03h CL = palette locking value: 

00h none 
Olh text modes only 
FFh all modes 
Conflicts: None known. 
See Also: Function CDh Subfunction 01h 


INTERRUPT 10h - Function CDh, Subfunction 04h 
GET UltraVision TEXT MODE 


Purpose: Determine current text mode display format. 


Available on: EGA and VGA systems, Restrictions: UltraVision, a video-BIOS extender 
program from Personics, Inc., must be 
loaded. 

Registers at call: Return Registers: 

AX = CD04h AL = mode number: see below. 


UltraVision mode numbers: 


11h 80x25 1Ch 94x63 
12h 80x43, 80x50 2th 108x25 
13h 80x34, 80x36 22h 108x43, 108x50 
14h 80x60, 80x63 23h 107x34, 108x36 
19h 94x25 24h 108x60, 108x63 
1Ah 94x43, 94x50 31h 120x25 


1Bh 94x36 32h 120x43, 120x50 
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UltraVision mode numbers (continued): 


33h 132x25 3Ah 120x63 
34h 132x44, 132x50 3Bh 132x36 
39h 120x36 3Ch 132x60 


Conflicts: None known. 
See Also: Function OFh, Function CCh Subfunction 00h, Function CDh Subfunctions 1 1h+ 


INTERRUPT 10h - Function CDh, Subfunction 05h 


SET CURSOR TYPE 

Purpose: Establish cursor style. 

Available on: EGA and VGA systems, Restrictions: UltraVision, a video-BIOS extender 
program from Personics, Inc., must be 
loaded. 

Registers at call: Return Registers: n/a. 

AX = CDOSh 

CL= 00h line cursor 

FFh box cursor 

Details: Sets default cursor type for text-based programs. 

Conflicts: None known. 

See Also: Function 01h, Function CDh Subfunction 06h 

INTERRUPT 10h - Function CDh, Subfunction 06h 

GET CURSOR TYPE 

Purpose: Determine current cursor style. 

Available on: EGA and VGA systems. Restrictions: UltraVision, a video-BIOS extender 
program from Personics, Inc., must be 
loaded. 

Registers at call: Return Registers: 

AX = CD06h CL = 00h line cursor 


FFh box cursor 
Conflicts: None known. 
See Also: Function 03h, Function CDh Subfunction 05h 


INTERRUPT 10h - Function CDh, Subfunction 07h 


SET UNDERLINE STATUS 

Purpose: Controls underline feature. 

Available on: EGA and VGA systems. Restrictions: Version 1.2 or higher of UltraVision, a 
video-BIOS extender program from 
Personics, Inc., must be loaded. 

Registers at call: Return Registers: 

AX = CDO7h CL = hardware underline status 

CL = hardware underline status: BL = current foreground color for normal text 

00h off (color systems only) BH = current foreground color for bright text 


Oth underline below characters 

02h strike through characters 
BL = foreground color for normal text 

(FFh = current) 
BH = foreground color for bright text 

(FFh = current) 
Details: When underline or strikeout is enabled in color text modes, the specified colors will be assigned temporarily 
to colors 01h and 09h, allowing affected text to match non-underlined text. The color remapping uses values from 
the current onscreen palette regardless of the palette locking status (see Function CDh Subfunction 01h). 

Specify the standard colors (BL=01h,BH=09h) to enable underline or strikeout without color remapping. 


| 
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Conflicts: None known. 
See Also: Function CDh Subfunction 08h 


INTERRUPT 10h - Function CDh, Subfunction 08h 


GET UNDERLINE STATUS 

Purpose: Determines current setting of hardware underline support. 

Available on: EGA and VGA systems. Restrictions: Version 1.2 or higher of UltraVision, a 
video-BIOS extender program from 
Personics, Inc., must be loaded. 

Registers at call: Return Registers: 

AX = CDO8h CL = hardware underline status (see Function CDh 


Subfunction 07h) 
BL = foreground color for normal text 
BH = foreground color for bright text 
Details: Only CL is valid on monochrome EGA systems. 
Conflicts: None known. 
See Also: Function CDh Subfunction 07h 


INTERRUPT 10h - Function CDh, Subfunction 10h 


LOAD USER FONT 

Purpose: Loads user-supplied font. 

Available on: EGA and VGA systems. Restrictions: UltraVision, a video-BIOS extender 
program from Personics, Inc., must be 
loaded. 

Registers at call: Return Registers: 

AX =CDIOh AX = FFFFh if invalid font parameters 

BH = bytes per character (08h, 0Ah, OBh, OEh, 13h, 

14h) 


CX = ABCDh load 9xN alternate font (v2-+) 
else number of characters to load 
DX = character offset into font table 
DS:SI -> 8-byte ASCII font name 
ES:BP -> font definitions 
Details: Loads the designated characters into UltraVision's resident font area. Should be followed by a video mode 
set to reload character generator. 
Conflicts: None known. 
See Also: Function 11h Subfunction 00h 


INTERRUPT 10h - Function CDh, Subfunctions 11h-FFh 
SET ULTRAVISION TEXT MODE 


Purpose: Select text display format. 


Available on: EGA and VGA systems. Restrictions: UltraVision, a video-BIOS extender 
program from Personics, Inc., must be 
loaded. 

Registers at call: Return Registers: 

AH =CDh AX = CDCDh if invalid mode 


AL = text mode number: see below. 


UltraVision mode numbers: 
11h 80x25 14h 80x60, 80x63 


12h 80x43, 80x50 19h 94x25 
13h 80x34, 80x36 1Ah 94x43, 94x50 
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UltraVision mode numbers (continued): 


1Bh 94x36 

1Ch 94x63 

2ih 108x25 

22h 108x43, 108x50 

23h 107x34, 108x36 

24h 108x60, 108x63 

31h 120x25 

32h 120x43, 120x50 

Conflicts: None known. 

See Also: Function CDh Subfunction 04h 


INTERRUPT 10h - Function EFh 
MSHERC.COM INSTALLATION CHECK??? 


Purpose: Extend capabilities of Hercules-equipped systems. 

Available on: Systems equipped with a Hercules 
graphics card or equivalent. 

Registers at call: 

AH = EFh 


33h 132x25 
34h 132x44, 132x50 
39h 120x36 
3Ah 12063 
3Bh 132x36 
3Ch 132x60 


Restrictions: MSHERC.COM must be loaded. 


Return Registers: 

DL = video adapter type: 
00h original Hercules 
O1h unknown. \ one is probably Hercules Plus, 
02h unknown, / the other Hercules InColor 
FFh non-Hercules 

DH = video memory mode byte 
OIh “half” (one page) 
03h "full" (two pages) 


Details: MSHERC.COM is a support program for the Microsoft Quick languages which makes their graphics 
libraries compatible with a Hercules card by adding video modes 08h and 88h, and supporting text in the new 
graphics modes. While in mode 08h or 88h, INT 10h supports the Hercules card much like a CGA. 


Conflicts: None known, 


INTERRUPT 10h - Function Foh 
EGA Register Interface Library - READ ONE REGISTER 


Purpose: Determine the current state of one 
Available on: EGA-equipped systems. 
Registers at call: 

AH = FOh 

BL = register number 

BH = 00h 

DX = group index (see table) 


RIL Group Index Codes 


Pointer/data chips 
00h CRT Controller (25 teg) 3B4h mono modes, 
3D4h color modes 
O8h Sequencer (5 registers) 3C4h 
10h Graphics Controller (9 registers) 3CEh 
18h Attribute Controller (20 registers) 3COh 
Details: The RIL is provided by the Microsoft Mouse driver, 


EGA registers as stored by the RIL. 


Restrictions; RIL must be loaded. 
Return Registers: 
BL = data 


Single registers 

20h Miscellaneous Output register 3C2h 

28h Feature Control register (3BAh mono modes, 
3DAh color modes) 

30h Graphics 1 Position register 3CCh 

38h Graphics 2 Position register 3CAh 

OS/2 compatibility box, and others; it provides a means 


for restoring the state of the EGA even though the EGA's registers are write-only. 


Conflicts: None known. 
See Also: Functions Flh and F2h 
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INTERRUPT 10h - Function Fih 
EGA Register interface Library - WRITE ONE REGISTER 


Purpose: Set an EGA register and update the RIL record of that register. 


Available on: EGA-equipped systems. Restrictions: RIL must be loaded. 
Registers at call: Return Registers: 
AH=Flh BL = data 


DX = group index (see Function FOh) 
if single register: 
BL = value to write 
otherwise 
BL = register number 


BH = value to write 
Details: The RIL is provided by the Microsoft Mouse driver, OS/2 compatibility box, and others; it provides a means 


for restoring the state of the EGA even though the EGA's registers are write-only. 
Conflicts: None known. 
See Also: Functions FOh and F3h 


INTERRUPT 10h - Function F2h 
EGA Register interface Library ~ READ REGISTER RANGE 


Purpose: Determine the values of a contiguous range of EGA registers. 


Available on: EGA-equipped systems. Restrictions: RIL must be loaded. 
Registers at call: Return Registers: n/a. 
AH = F2h 


CH = starting register number 
CL = Number of registers (>1) 
DX = group index 

00h CRTC (3B4h mono modes, 

3D4h color modes) 

08h Sequencer 3C4h 

10h Graphics Controller 3CEh 

18h Attribute Controller 3COh 
ES:BX -> buffer, CL bytes 
Details: The RIL is provided by the Microsoft Mouse driver, OS/2 compatibility box, and others; it provides a means 
for restoring the state of the EGA even though the EGA's registers are write-only, 
Conflicts: None known. 
See Also: Functions F0h and F3h 


INTERRUPT 10h - Function F3h 
EGA Register Interface Library - WRITE REGISTER RANGE 


Purpose: Set a contiguous range of EGA registers, recording the new values. 


Available on: EGA-equipped systems. Restrictions: RIL must be loaded. 
Registers at call: Return Registers: n/a. 
AH = F3h 


CH = starting register 

CL = number of registers (>1) 

DX = group index (see Function F2h) 

ES:BX -> buffer, CL bytes 

Details: The RIL is provided by the Microsoft Mouse driver, OS/2 compatibility box, and others; it provides a means 
for restoring the state of the EGA even though the EGA's registers are write-only. 

Conflicts: None known. 

See Also: Functions Flh and F2h 
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INTERRUPT 10h - Function Fah 
EGA Register Interface Library - READ REGISTER SET 


Purpose: Determine the values of multiple non-contiguous EGA registers. 


Available on: EGA-equipped systems. Restrictions: RIL must be loaded. 
Registers at call: Return Registers: 
AH = F4h register values in table filled in 


CX = number of registers to read (>1) 

ES:BX -> table of records (Table 5-22) 

Details: The RIL is provided by the Microsoft Mouse driver, OS/2 compatibility box, and others; it provides a means 
for restoring the state of the EGA even though the EGA's registers are write-only. 

Conflicts: None known. 

See Also: Functions FOh, F2h, and F5h 


Table 5-22. Format of entries in table of register records: 


Offset Size Description 
00h WORD group index 
Pointer/data chips 
00h CRTC (3B4h mono modes, 3D4h color modes) 
O8h Sequencer 3C4h 
10h Graphics Controller 3CEh 
18h Attribute Controller 3COh 
Single registers 
20h Miscellaneous Output register 3C2h 
28h Feature Control register (BAh mono modes, 3DAhcolor) 
30h Graphics 1 Position register 3CCh 
38h Graphics 2 Position register 3CAh 
02h BYTE register number (0 for single registers) 
03h BYTE register value 


INTERRUPT 10h - Function F5h 
EGA Register Interface Library - WRITE REGISTER SET 


Purpose: Set multiple non-contiguous EGA registers, recording the new values. 


Available on: EGA-equipped systems. Restrictions: RIL must be loaded. 
Registers at call: Return Registers: n/a. 
AH = F5h 


CX = number of registers to write (>1) 

ES:BX -> table of records (see Function F4h) 

Details: The RIL is provided by the Microsoft Mouse driver, OS/2 compatibility box, and others; it provides a means 
for restoring the state of the EGA even though the EGA's registers are write-only. 

Conflicts: None known. 

See Also: Functions Flh, F3h, and F4h 


INTERRUPT 10h - Function Féh 
EGA Register interface Library - REVERT TO DEFAULT REGISTERS 


Purpose: Set all EGA registers to previously-specified default values, 


Available on: EGA-equipped systems. Restrictions: RIL must be loaded. 
Registers at call: Return Registers: n/a. 
AH = F6h 


Details: The RIL is provided by the Microsoft Mouse driver, OS/2 compatibility box, and others; it provides a means 
for restoring the state of the EGA even though the EGA's registers are write-only. 

Conflicts: None known. 

See Also: Function F7h 
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INTERRUPT 10h - Function F7h 
EGA Register interface Library - DEFINE DEFA ULT REGISTER TABLE 


Purpose: Specify the default values to be used by Function F6h. 


Available on: EGA-equipped systems. Restrictions: RIL must be loaded. 
Registers at call: Return Registers: n/a. 
AH = F7h 


DX = port number (see Group Index table) 
ES:BX -> table of one-byte entries, one byte to be 
written to each register 


RIL Group Index Codes 


Pointer/data chips Single registers 
00h CRT Controller (25 reg) 3B4h mono modes, 20h Miscellaneous Output register 3C2h 
3D4h color modes 28h Feature Control register (3BAh mono modes, 
08h Sequencer (5 registers) 3C4h 3DAh color modes) 
10h Graphics Controller (9 registers) 3CEh 30h Graphics 1 Position register 3CCh 
18h Attribute Controller (20 registers) 3COh 38h Graphics 2 Position register 3CAh 


Details: The RIL is provided by the Microsoft Mouse driver, OS/2 compatibility box, and others; it provides a means 
for restoring the state of the EGA even though the EGA's registers are write-only. 

Conflicts: None known. 

See Also: Function F6h 


INTERRUPT 10h - Function FAh 
EGA Register Interlace Library - INTERROGATE DRIVER 


Purpose: Determine whether a Register Interface Library provider is loaded. 


Available on: EGA-equipped systems. Restrictions: none. 

Registers at call: Return Registers: 

AH = FAh BX = 0000h if mouse driver not present 

BX = 0000h ES:BX -> EGA Register Interface version number, if 
present: 


byte 0 = major release number 
byte 1 = minor release number 
Details: The RIL is provided by the Microsoft Mouse driver, OS/2 compatibility box, and others; it provides a means 
for restoring the state of the EGA even though the EGA's registers are write-only, 
Conflicts: FASTBUFF Installation Check (chapter 36). 
See Also: Function F6h 


INTERRUPT 10h - Function FFh 
DJ GO32,EXE 80386+ DOS extender VIDEO EXTENSIONS 


Purpose: Allow simplified video mode setting 
Available on: 80386 and higher. Restrictions: Must be executing under DJ GO32.EXE 
DOS extender. 
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Registers at call: Return Registers: n/a 
AH = FFh 
AL = video mode: 
00h 80x25 text 
Oth default text 
02h CXxDX text 
03h biggest text 
04h 320x200 graphics 
O5h default graphics 
06h CXxDX graphics 
O7h biggest non-interlaced graphics 
08h biggest graphics 
Conflicts: TopView (chapter 15), Carbon Copy Plus (chapter 28), 
See Also: Function 00h, GO32.EXE INT 21h Function FEh (chapter 8) 


INTERRUPT 14h - Function 81h, Subfunction 00h 
RETURN VIDEO FOSSIL INFORMATION 


Purpose: To determine configuration of Video FOSSIL when present, 


Available on; All machines, Restrictions: Video FOSSIL must be installed, 
Registers at call: Return Registers: 
AX = 8100h AX = 1954h if installed 


ES:DI -> buffer for VFOSSIL information 

(Table 5-23) 
Details: The Video FOSSIL is an appendage which may be installed in any standard FOSSIL driver. It supports a 
subset of the OS/2 video functions, permitting porting between the VFOSSIL and OS/2 with minimal changes. 
Conflicts: COURIERS.COM (chapter 7). 
See Also: Function 81h Subfunction 01h, FOSSIL Function 7Eh (chapter?) 


Table 5-23. Format of VFOSSIL information: 


Offset Size Description 

00h WORD size of information in bytes, including this field 

02h WORD VFOSSIL major version 

04h WORD VFOSSIL revision level 

06h WORD highest VFOSSIL application function supported 

INTERRUPT 14h - Function 81h, Subfunction 01h 

OPEN VIDEO FOSSIL 

Purpose: Initializes Video FOSSIL and returns pointers to the functions which it provides, 

Available on: All machines. Restrictions: Video FOSSIL must be installed, 
Registers at call: Return Registers: 

AX = 8101h AX = 1954h if installed 

ES:DI -> buffer for application function table BH = highest VFOSSIL application function supported 


(Table 5-24) 
CX = length of buffer in bytes 
Details: The number of initialized pointers in the application function table will never exceed CX/4; if the buffer is 
large enough, BH+1 pointers will be initialized. All functions of Video FOSSIL are called indirectly through the far 
pointers in the application function table, with parameters passed on the stack as described in the following 
paragraphs. 

The Video FOSSIL is an appendage which may be installed in any standard FOSSIL driver, It supports a subset 
of the OS/2 video functions, permitting porting between the VFOSSIL and O$/2 with minimalchanges. 
Conflicts: COURIERS.COM (chapter 7). 
See Also: Function 81h Subfunction 02h 
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Table 5-24. Format of application function table: 











Offset Size Description 

00h DWORD _ far pointer to VioGetMode function (query current video mode) 

04h DWORD far pointer to VioSetMode function (set video mode) 

08) DWORD far pointer to VioGetConfig function (query hardware config) 

0Ch DWORD far pointer to VioWrtTTY function (write data in TTY mode) 

10h DWORD _ far pointer to VioGetANSI function (get current ANSI state) 

14 DWORD far pointer to VioSetANSI function (set new ANSI state) 

18 DWORD far pointer to VioGetCurPos function (get cursor position) 

1Ch DWORD _ far pointer to VioSetCurPos function (set cursor position) 

20h DWORD far pointer to VioGetCurType function (get cursor shape) 

24 DWORD far pointer to VioSetCurType function (set cursor shape) 

28 DWORD far pointer to VioScrollUp function (scroll screen up) 

2Ch DWORD far pointer to VioScrollDn function (scroll screen down) 

30h DWORD far pointer to VioReadCellStr function (read cell string from screen) 
34) DWORD far pointer to VioReadCharStr function (read charstring from screen) 
38h DWORD far pointer to VioWrtCellStr function (write a cell string) 

3Ch DWORD far pointer to VioWrtCharStr function (write char string, leaving attr) 
40h DWORD far pointer to VioWrtCharStrAttr function (write charstring, const attr) 
44h DWORD far pointer to VioWrtNAttr function (replicate an attribute) 

48 DWORD far pointer to VioWrtNCell function (replicate a cell) 

4Ch DWORD far pointer to VioWrtNChar function (replicate a character) 








Call VioGetMode with: 
STACK: WORD VIO handle (must be 00h) 
DWORD _ pointer to video mode data structure (Table 5-25). 


Returns with: 
AX = error code: 
0000h successful 
0074h internal VIO failure 
017Eh buffer too small 
01B4h invalid VIO handle 


Table 5-25, Format of video mode data structure: 


Offset Size Description 
00h WORD length of structure including this field 
02h BYTE mode characteristics: 


bit 0: clear if MDA, set otherwise 
bit 1: graphics mode 
bit 2: color disabled (black-and-white) 


03h BYTE number of colors supported (1=2 colors, 4=16 colors,etc) 
04h WORD number of text columns 

06h WORD number of text rows 

O8h WORD reserved 

OAh WORD reserved 

0Ch DWORD _ reserved 


Call VioSetMode with: 
STACK: WORD VIO handle (must be 00h) 
DWORD _ pointer to video mode data structure (Table 5-25) 


Returns with: 
AX = error code: 
0000h successful 
0074h internal V1O failure 
0163h unsupported mode 
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O17Eh buffer too small 
OLASh invalid VIO parameter 
01B4h invalid VIO handle 


Call VioGetConfig with: 
STACK: WORD VIO handle (must be 00h) 
DWORD pointer to video configuration data buffer (Table 5-26). 


Returns with: 
AX = error code: 
0000h successful 
0074h internal VIO failure 
O17Eh buffer too smail 
01B4h invalid VIO handle 


Table 5-26. Format of video configuration data: 


Offset Size Description 
00h WORD structure length including this field 
02h WORD adapter type: 
00h monochrome/printer 
Olh CGA 
02h EGA 
03h VGA 
O7h 8514/A 
04h WORD display type: 
00h monochrome 
Oth color 
02h enhanced color 
09h 8514 
06h. DWORD adapter memory size 


Call VioWrtTTY with: 
STACK: WORD VIO handle (must be 00h) 
WORD length of string 
DWORD _ pointer to character string to be written to screen 


Returns with: 
AX = error code: 
0000h successful 
0074h internal VIO failure 
01B4h invalid VIO handle 
Details: Write wraps at end of line and terminates if it reaches end of screen. In ANSI mode, ANSI control 
sequences are interpreted, and this function is not required to be reentrant; in non-ANSI mode, the function is 
reentrant and may be called from within an MS-DOS function call. 


Call VioGetANSI with: 
STACK: WORD VIO handle (must be 00h) 
DWORD _ pointer to WORD which will be set to 00h if ANSI is off or O1h if ANSI is on 


Returns with: 
AX = error code: 
0000h successful 
0074h internal VIO failure 
01B4h invalid VIO handle 


Call VioSetANSI with: 
STACK: WORD VIO handle (must be 00h) 
DWORD pointer to WORD indicating new state of ANSI 
00h off 
Olh on 
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Returns with: 
AX = error code: 

0000h successful 
0074h internal VIO failure 
0163h unsupported mode 
0166h invalid row value 
0167h invalid column value 
017Eh buffer too small 
01A5h invalid VIO parameter 
01B4h invalid VIO handle 


Call VioGetCurPos with: 
STACK: WORD VIO handle (must be 00h) 
DWORD pointer to WORD to hold current cursor column (0-based) 
DWORD pointer to WORD to hold current cursor row (0-based) 


Returns with: 
AX = error code: 
0000h successful 
0074h internal VIO failure 
01B4h invalid VIO handle 


Call VioSetCurPos with: 
STACK: WORD VIO handle (must be 00h) 
WORD cursor column 
WORD cursor row 


Returns with: 
AX = error code: 
0000h successful 
0074h internal VIO failure 
0166h invalid row value 
0167h invalid column value 
01B4h invalid VIO handle 
Details: If either coordinate is invalid, the cursor is not moved. 


Call VioGetCurType with: 
STACK: WORD VIO handle (must be 00h) 
DWORD pointer to cursor type record (Table 5-27). 


Returns with: 
AX = error code: 
0000h successful 
0074h internal VIO failure 
01B4h invalid VIO handle 


Table 5-27. Format of cursor type record: 


Offset Size Description 

00h WORD cursor start line 

02h WORD cursor end line 

04h WORD cursor width (always Oth) 

06h WORD cursor attribute (FFFFh = hidden) 


Call VioSetCurType with: 
STACK: WORD VIO handle (must be 00h) 
DWORD pointer to cursor type record (see above) 


Returns with: 
AX = error code: 
0000h successful 
0074h internal VIO failure 


5-67 


5-68 Video 


OIASh invalid VIO parameter 
01B4h invalid VIO handle 


Call VioScrollUp with: 

STACK: WORD VIO handle (must be 00h) 
DWORD _ pointer to char/attr cell for filling emptied rows 
WORD number or rows to scroll (FFFFh = clear area) 
WORD right column of scroll area 
WORD __ bottom row of scroll area 
WORD _sieft column of scroll area 
WORD top row of scroll area 


Returns with: 
AX = error code: 
0000h successful 
0074h internal VIO failure 
0166h invalid row value 
0167h invalid column value 
01B4h invalid VIO handle 


Call VioScrollDn with: 

STACK: WORD VIO handle (must be 00h) 
DWORD _ pointer to char/attr cell for filling emptied rows 
WORD number or rows to scroll (RFFFh = clear area) 
WORD right column of scroll area 
WORD __ bottom row of scroll area 
WORD left column of scroll area 
WORD _ top row of scroll area 


Returns with: 
AX = error code: 
0000h successful 
0074h internal VIO failure 
0166h invalid row value 
0167h invalid column value 
01B4h invalid VIO handle 


Call VioReadCellStr with: 
STACK: WORD _ VIO handle (must be 00h) 
WORD column at which to start reading 
WORD _ row at which to start reading 


DWORD pointer to WORD containing length of buffer in bytes; 
on return, WORD contains number of bytes actuaily read 


DWORD _ pointer to buffer for cell string 


Returns with: 
AX = error code: 
0000h successful 
0074h internal VIO failure 
0166h invalid row value 
0167h invalid column value 
01B4h invalid VIO handle 


Call VioReadCharStr with: 
STACK: WORD VIO handle (must be 00h) 
WORD column at which to start reading 
WORD Tow at which to start reading 


DWORD 
DWORD 


pointer to WORD containing length of buffer in bytes 
on return, WORD contains number of bytes actually read 
pointer to buffer for character string 





Returns with: 
AX = error code: 
0000h successful 
0074h internal VIO failure 
0166h invalid row value 
0167h invalid column value 
01B4h invalid VIO handle 


Call VioWrtCellStr with: 
STACK: WORD VIO handle (must be 00h) 
WORD column at which to start writing 
WORD row at which to start writing 
WORD length of cell string in bytes 
DWORD pointer to cell string to write 


Returns with: 
AX = error code: 
0000h successful 
0074h internal VIO failure 
0166h invalid row value 
0167h invalid column value 
01B4h invalid VIO handle 
Details: Write wraps at end of line and terminates if it reaches the end ofthe screen. 


Call VioWrtCharStr with: 
STACK: WORD VIO handle (must be 00h) 
WORD _ colurm at which to start writing 
WORD row at which to start writing 
WORD _length of character string 
DWORD _ pointer to character string to write 


Returns with: 
AX = error code: 
0000h successful 
0074h internal VIO failure 
0166h invalid row value 
0167h invalid column value 
01B4h invalid VIO handle 
Details: Write wraps at end of line and terminates if it reaches the end ofthe screen. 


Call VioWrtCharStrAttr with: 
STACK: WORD VIO handle (must be 00h) 
DWORD _ pointer to attribute to be applied to each character 
WORD column at which to start writing 
WORD __ row at which to start writing 
WORD _length of character string 
DWORD pointer to character string to write 


Returns with: 
AX = error code: 
0000h successful 
0074h internal VIO failure 
0166h invalid row value 
0167h invalid column value 
01B4h invalid VIO handle 
Details: Write wraps at end of line and terminates if it reaches the end ofthe screen. 


Call VioWrtNAttr with: 
STACK: WORD VIO handle (must be 00h) 
WORD column at which to start writing 
WORD row at which to start writing 
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WORD __ number of times to write attribute 
DWORD _ pointer to display attribute to replicate 


Returns with: 
AX = error code: 
0000h successful 
0074h internal VIO failure 
0166h invalid row value 
0167h invalid column value 
01B4h invalid VIO handle 


Details: Write wraps at end of line and terminates if it reaches the end ofthe screen. 


Call VioWrtNCell with: 
STACK: WORD VIO handle (must be 00h) 
WORD column at which to start writing 
WORD row at which to start writing 
WORD _ number of times to write cell 
DWORD _ pointer to cell to replicate 


Returns with: 
AX = error code: 
0000h successful 
0074h internal VIO failure 
0166h invalid row value 
0167h invalid column value 
01B4h invalid VIO handle 


Details: Write wraps at end of line and terminates if it reaches the end ofthe screen. 


Call VioWrtNChar with: 
STACK: WORD VIO handle (must be 00h) 
WORD column at which to start writing 
WORD _ row at which to start writing 
WORD ___ number of times to write character 
DWORD _ pointer to character to replicate 


Returns with: 
AX = error code: 
0000h successful 
0074h internal VIO failure 
0166h invalid row value 
0167h invalid column value 
01B4h invalid VIO handle 


Details: Write wraps at end of line and terminates if it reaches the end ofthe screen, 


INTERRUPT 14h - Function 81h, Subfunction 02h 
CLOSE VIDEO FOSSIL 


Purpose: Terminates operation of the Video FOSSIL. 


Available on: All machines. Restrictions: Video FOSSIL must be installed. 
Registers at call: Return Registers: 
AX = 8102h AX = 1954h 


Details: Terminates all operations; after this call, the video FOSSIL 
reinitialized. 

Conflicts: COURIERS.COM (chapter 7). 

See Also: Function 81h Subfunctions 01h and 03h 


INTERRUPT 14h - Function 81h, Subfunction 03h 
UNINSTALL VIDEO FOSSIL 


Purpose: Removes the Video FOSSIL routines from memory. 


may be either removed from memory or 


Available on: All machines. Restrictions: Video FOSSIL must be installed. 
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Registers at call: Return Registers: 
AX = 8103h AX = 1954h 
Details: This is an extension to the VFOSSIL spec by Bob Hartman's VFOS_IBM. 
Conflicts; COURIERS.COM (chapter 7). 


INTERRUPT 16h - Function AAh 
CALL GATE FOR Paint Tools GRAPHICS 


Purpose: Paint Tools is a graphics library for Turbo Pascal, Modula 2 and others from DataBiten in Sweden. The 
Library is installed as a memory resident driver. 


Ayailable on: All machines. Restrictions: PTxxx.COM (xxx = CGA, EGA, VGA, 
HER, ...) must be installed. 

Registers at call: Return Registers: 

AH = AAh Graphics performed. 


Various registers set up by high level language. 
Conflicts: None known. 


INTERRUPT 1Dh 

VIDEO PARAMETER TABLES 

Purpose: This is not an interrupt; the vector contains the address of the currently active video parameter table. 
Available on: All machines. Restrictions: none. 

Registers at call: n/a Return Registers: n/a. 


Details: Default video parameter table (Table 5-28) is located at FOOOh:FOA4h for 100% compatible BIOSes. 
Conflicts: None known. 
See Also: INT 10h Function 00h 


Table 5-28. Format of video parameter table: 


Offset Size Description 

00h 16 BYTEs 6845 register values for modes 00h and O1h 

10h 16 BYTEs 6845 register values for modes 02h and 03h 

20h 1GBYTEs 6845 register values for modes 04h and 05h 

30h 16BYTEs 6845 register values for modes 06h and 07h 

40h WORD bytes in video buffer for modes 00h and O1h 

42h WORD bytes in video buffer for modes 02h and 03h 

44h WORD bytes in video buffer for modes 04h and OSh 

46h WORD __ bytes in video buffer for modes 06h and 07h 

48h 8BYTEs columns on screen for each of modes 00h through 07h 
50h 8BYTEs CRT controller mode bytes for cach of modes 00h through 07h 
INTERRUPT 1Fh 

8x8 GRAPHICS FONT 


Purpose: This is not an interrupt; the vector contains the address of a 1024-byte table of bitmap data, 8 bytes for 
each character 80h-FFh, which provides the 8x8 character font used in graphics modes. 

Available on: All machines. Restrictions: Used in graphics modes only. 

Registers at call: n/a Return Registers: n/a. 

Details: Graphics data for characters 00h-7Fh is stored at F000h:FAGEh in 100% compatible BIOSes. 

See Also: INT 43h, INT 44h 


INTERRUPT 2Fh - Function 64h, Subfunction 00h 
Multiplex - SCRNSAV2.COM INSTALLATION CHECK 


Purpose: Determine whether SCRNSAV2.COM screen-saver TSR is installed. 
Available on: All machines. Restrictions: none. 
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Registers at call: Return Registers: 
AX = 6400h AL = 00h not installed 

= FFh installed 
Details: SCRNSAV2.COM is a screen saver for PS/2's with VGA by Alan Ballard. 
INTERRUPT 42h 


RELOCATED DEFAULT INT 10h VIDEO SERVICES 


Purpose: Replaces INT 10h for default video services when INT 10h is re-routed to video card's ROM. 
Available on: Systems equipped with EGA or Restrictions: none. 

VGA. 
See Also: INT 10h 


INTERRUPT 43h 
CHARACTER TABLE 


Purpose: This is not an interrupt; the vector contains the address of graphics data for characters 0Oh-7Fh of the 
current font, 


Available on: Systems equipped with EGA, Restrictions: none. 
MCGA, or VGA. 
Registers at call: n/a Return Registers: n/a. 


Conflicts: Z100 (chapter 2) 
See Also: INT 1Fh, INT 44h 


INTERRUPT 44h 
ROM BIOS CHARACTER FONT, CHARACTERS 00h-7Fh 


Purpose: This is not an interrupt; the vector contains the address of graphics data for the current character font. 
Available on: PCjr only. Restrictions: none. 

Registers at call: n/a Return Registers: n/a. 

Conflicts: Z100 (chapter 2), Novell NetWare (chapter 20). 

See Also: INT 1Fh, INT 43h 


INTERRUPT 59h 
GSS Computer Graphics Interface (GSS*CGI) 


Purpose: INT 59h is the means by which GSS*CGI language bindings communicate with GSS*CGI device drivers 
and the GSS*CGI device driver controller, Also used by the IBM Graphic Development Toolkit. 


Available on: All machines. Restrictions: Appropriate device drivers must be 
installed. 

Registers at call: Return Registers: 

DS:DX -> block of 5 array pointers CF set on error 


AX = error code 
CF clear if successful 
AX = return code 
Conflicts: DESQview 2.26+ IRQ8 (chapter 2), DoubleDOS IRQI (chapter 2). 


INTERRUPT 6Dh 
ATI VGA Wonder - VIDEO BIOS ENTRY POINT 


Purpose: Called internally by ATI VGA Wonder video BIOS. Points at the original INT 10h entry point set up by 
the ATI BIOS. 


Available on: Systems equipped with an ATI VGA Restrictions: none. 
Wonder video card. 

Registers at call: Return Registers: n/a. 

See INT 10h. 


Conflicts: VGA internal, DECnet DOS CTERM (chapter 24). 
See Also: INT 10h 
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INTERRUPT 6Dh 
VGA - internal 


Purpose: unknown. 
Available on: All machines. 


Details: Used by IBM, Paradise, Video7, and NCR. 
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Restrictions: Specific video BIOS using this must be 


present. 


Conflicts: ATI VGA Wonder, DECnet DOS CTERM (chapter 24). 


INTERRUPT 7Fh 
Halo88 API 


Purpose: Halo88 is a suite of graphics routines. 


Available on: All machines. 
Registers at call: 
BX = function code (Table 5-29) 


Table 5-29, HALO Function Codes 


64h are 
65h bar 
66h box 
67h circle 
68h clr 
69h default hatch style 
6Ah default line style 
6Bh delhcur 

6Ch delin / deltcur 
6Dh ellipse 

6Eh fill 
6Fh flood 
70h fload2 

71h init graphics 
72h init hour 

73h init marker 
74h init tour 

75h ingare 

76h ingbknd 

77h ingelr 

78h ingerr 

79h inqgcur 

7Ah inghcur 

7Bh ingmarker 
7Dh ingtcur 

TEh ingtext 

7Fh Inabs 

80h Inrel 

81h markerabs 
82h markerrel 
83h moveabs 

84h moveheurabs 
85h movehcurrel 
86h moverel 

87h movetcurabs 
88h movetcurrel 











Restrictions: none. 
Return Registers: unknown. 


89h movefrom 
8Ah moveto 

8Bh pie 

8Ch polylnabs 
8Dh polylnrel 
8Eh ptabs 

8Fh ptrel 

91h setasp 

92h set color 
93h set font 

94h set hatch style 
95h set line style 
97h settext 

98h set text color 
99h btext 

9Ah setseg 

9Bh display 

9Ch setscreen 
9Eh close graphics 
Fh ftinit 

AOh ftlocate 
Alh ftext 

ASh set viewport 
A6h set window 
ATh set world 
AAh ftcolor 
ACh initlp 

ADh ingasp 
AEh ingdev 

AFh ingdisplay 
BOh ingft 

Blh ingftcolor 
B2h inginterlace 
B3h inglpa 

B4h inglpg 

B5h inqmode 
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Table 5-29. HALO Function Codes (1 continued) 























B6h ingscreen F4h ingdrange 
B7h ingversion FSh ingstang 
B&h roam F6h orglocator 
B9h scroll F7h inglocator 
BAh setieee F8h ingarea 
BBh set interlace F9h setipal 
BCh shift FAh setborder 
BDh start graphics FBh inqcrange 
BEh vpan FEh setclip 
CBh gwrite FFh fcir 
CCh gread 100h setcrange 
CDh setxor Oh setdrange 
CEh rbox 102h setlattr 
CFh reir 03h polycabs 
DOh rinabs 04h polycrel 
Dth rlnrel 108h memcom 
D2h delbox 09h memexp 
D3h delcir OAh memmov 
D5h setseg2 10Eh movefx 
DCh worldoff OFh movetx 
DDh mapwtod 10h ingrgb 
DEh mapdtow 111h save image 
DFh mapwton 12h restore image 
E0h mapntow 113h setapal 
Eih mapdton 114h setxpal 
E2h mapntod 118h inqtsize 
E3h inqworld 2Eh gprint 
E4h inqviewport 130h setprn 
E5h set line width 131h setpattr 
E6h Injoint 133h setbattr 
E7h set locator 135h pexpand 
E8h read locator 36h ptnorm 
E9h setdev 137h pfnorm 
EBh setstext 13Bh inqprn 
ECh setstelr 13Ch lopen 
EDh setstang 13Dh Iclose 
EEh stext 13Eh lappend 
EFh ingstext 13Fh Irecord 
FOh setdegree 140h Iswitch 
Fih ingstsize 142h ingfun 
F2h polyfabs 15Dh setup 
F3h polyfrel 15Eh Irest 
1SFh Isave 


Additional parameters on stack. 
Details: According to Stuart Kemp, the code appears to make no provisions for chaining. 
Conflicts: Alloy NTNX and MW386 (chapter 18), ClusterShare access (chapter 27). 


INTERRUPT 7Fh - Function 01h, Subfunction 05h 
HDILOAD.EXE - 8514/A VIDEO CONTROLLER INTERFACE 
Purpose: Determine the addresses to call in order to manipulate the 8514/A display. 


Available on: Systems equipped with 8514/A Restrictions: HDILOAD.EXE must be installed. 
display adapter. 
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Registers at call: Return Registers: 
AX =0105h CF set on error 

CF clear if successful 

CX:DX -> array of FAR pointers to entry points 

Details: Most 8514/A functions are invoked by pushing the DWORD parameter block pointer and then performing a 
FAR call via the appropriate vector of the entry point array. 
Conflicts: Halo88 (chapter 5), Alloy 386/MultiWare and NTNX (chapter 18), Convergent Technologies 
ClusterShare (chapter 27). 
Function numbers: (do FAR cali via entry_points + 4 * function) 


08h HOPEN 1Dh HQMODE 
10h HINT 22h HCLOSE 
13h HLDPAL 30h HINIT 

15h HBBW 3lh HSYNC 
17h HBBR 39h HSPAL 


18h HBBCHN 3Ah HRPAL 
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Low-Level Disk I/O 


This chapter discusses the interrupt functions that provide low-level disk input/output capability. Since disk systems 
usually funnel all J/O operations through these functions, many add-on and third-party products hook into them and 
relocate the original functions to other vectors. We have separated the listings into six major subdivisions to help you 
locate specific functions: General-Usage functions are those which normally remain unchanged; Floppies are those 
functions used only for floppy-disk operation and which are often relocated when a system contains both floppy and 
fixed disk drives; Hard Disks describes the functions used only with fixed or hard disks; Special Controllers includes 
those functions used with ESDI, SCSI, and other advanced interfaces; Disk Caches includes the functions that support 
cache programs; and Disk Compression includes functions supported by programs which automatically compress data 
written to the disk, 

Within each of these subdivisions, functions are listed by numeric sequence of interrupt number, function, and 
subfunction; potential conflicts with other functions are noted. When no chapter reference appears for a listed conflict, 
the conflicting function is also described in this chapter. 


General-Usage Functions 
The functions described in this section are used by all standard disk interfacing routines, whether dealing with floppy 


disks or fixed drives. 


INTERRUPT 13h - Function 00h 
RESET DISK SYSTEM 


Purpose: Restores disk system conditions to power-up state. 
Available on: All machines, Restrictions: none. 
Registers at call: Return Registers: 
AH = 00h AH = status (Table 6-1) 
DL = drive (if bit 7 is set both hard disks and floppy 
disks are reset) 
Details: Forces controller to recalibrate drive heads (seek to track 0). 
Conflicts: None known. 
See Also: Functions ODh and 11h, INT 21h Function 0Dh (chapter 8) 


INTERRUPT 13h - Function 01h 
GET STATUS OF LAST OPERATION 


Purpose: Determine status resulting from previous disk operation. 


Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AH = 01h AH = status of previous operation 


DL = drive (bit 7 set for hard disk) 
Details: The PS/2 Model 30/286 returns the status in both AH and AL. 
Conflicts: None known. 
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Table 6-1. Values of Disk Status Codes 


00h successful completion 

Olh invalid function in AH or invalid parameter 
02h address mark not found 

03h disk write-protected (floppy) 

04h sector not found 

OSh reset failed (hard disk) 

06h disk changed (floppy) 

07h drive parameter activity failed (hard disk) 
08h DMA overrun 

09h attempted DMA across 64K boundary 
OAh bad sector detected (hard disk) 

OBh bad track detected (hard disk) 

OCh unsupported track or invalid media 


INTERRUPT 13h - Function 02h 
READ SECTOR(S) INTO MEMORY 


ODh invalid number of sectors on format (hard disk) 
QEh control data address mark detected (hard disk) 
OFh DMA arbitration level out of range (hard disk) 
10h uncorrectable CRC or ECC error on read 

11h data ECC corrected (hard disk) 

20h controller failure 

40h seek failed 

80h timeout (not ready) 

AAh drive not ready (hard disk) 

BBh undefined error (hard disk) 

CCh write fault (hard disk) 

EOh status register error (hard disk) 

FFh sense operation failed (hard disk) 





Purpose: Read data from disk using absolute cylinder, head, and sector addresses. 


Available on: All machines. 
Registers at call: 
AH =02h 
AL = number of sectors to read (must be nonzero) 
CH = low eight bits of cylinder number 
CL = sector number (bits 0-5) 

high two bits of cylinder 

(bits 6-7, hard disk only) 

DH = head number 
DL = drive number (bit 7 set for hard disk) 
ES:BX -> data buffer 


Restrictions: none. 
Return Registers: 
CF set on error 
CF clear if successful 
AH 5 status (Table 6-1) 
if AH = 11h (corrected ECC error), 
AL = burst length 
AL = number of sectors transferred 


Details: Errors on a floppy may be due to the motor failing to spin up quickly enough; the read should be retried at 
least three times, resetting the disk with Function 00h between attempts. DOS does this automatically. 

The AWARD AT BIOS has been extended to handle more than 1024 cylinders by placing bits 10 and 11 of the 
cylinder number into bits 6 and 7 of DH. The AMI BIOS apparently also follows this convention. 


Conflicts: None known. 
See Also: Function 03h, Hard Disk Function 0Ah 


INTERRUPT 13h - Function 03h 
WRITE DISK SECTOR(S) 


Purpose: Write data to disk using absolute cylinder, head, and sector addresses. 


Available on: All machines. 
Registers at call: 
AH = 03h 
AL = number of sectors to write (must be nonzero) 
CH = low eight bits of cylinder number 
CL = sector number (bits 0-5) 

high two bits of cylinder 

(bits 6-7, hard disk only) 

DH = head number 
DL = drive number (bit 7 set for hard disk) 
ES:BX -> data buffer 


Restrictions: none. 

Return Registers: 

CF set on error 

CF clear if successful 

AH & status (Table 6-1) 

AL = number of sectors transferred 


Details: Errors on a floppy may be due to the motor failing to spin up quickly enough; the write should be retried at 
least three times, resetting the disk with Function 00h between attempts. DOS does so automatically. 
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The AWARD AT BIOS has been extended to handle more than 1024 cylinders by placing bits [0 and 11 of the 
cylinder number into bits 6 and 7 of DH. The AMI BIOS apparently also follows this convention. 


Conflicts: None known. 
See Also: Function 02h, Hard Disk Function OBh 


INTERRUPT 13h - Function 04h 
VERIFY DISK SECTOR(S) 


Purpose: Check whether one or more sectors were correctly written to disk by comparing the data in the sector 


against the CRC stored on the disk. 
Available on: All machines. 
Registers at call: 
AH = 03h 
AL = number of sectors to verify (must be nonzero) 
CH = low eight bits of cylinder number 
CL = sector number (bits 0-5) 

high two bits of cylinder 

(bits 6-7, hard disk only) 
DH = head number 
DL = drive number (bit 7 set for hard disk) 
ES:BX -> data buffer (PC, XT, AT with BIOS prior 
to 11/15/85) 


Restrictions: none. 

Return Registers: 

CF set on error 

CF clear if successful 

AH = status (Table 6-1) 

AL = number of sectors verified 


Details: Errors on a floppy may be due to the motor failing to spin up quickly enough; the write should be retried at 
least three times, resetting the disk with Function 00h between attempts. 

The AWARD AT BIOS has been extended to handle more than 1024 cylinders by placing bits 10 and 11 of the 
cylinder number into bits 6 and 7 of DH, The AMI BIOS apparently also follows this convention. 


Conflicts: None known. 
See Also: Function 02h 


INTERRUPT 13h - Function 08h 
GET DRIVE PARAMETERS 


Purpose: Obtain parameters for the specified drive, either floppy or fixed. 


Available on: PC, XT286, Convertible, and PS/2 
models. 

Registers at call: 

AH = 08h 

DL = drive (bit 7 set for hard disk) 


Details: This function may return successfully even though the specified drive number is greater than the number of 


Restrictions: none. 


Return Registers: 
CF set on error 
AH = status (07h) (Table 6-1) 
CF clear if successful 
AH = 00h 
BL = drive type (see function 17h) 
(AT/PS2 floppies only) 
CH = low eight bits of maximum cylinder number 
CL = maximum sector number (bits 5-0) 
high two bits of maximum cylinder number 
(bits 7-6) 
DH = maximum head number 
DL = number of drives 
ES:DI -> drive parameter table (floppies only) 


attached drives of that type (floppy or hard). The calling program should check DL to ensure validity. 


Conflicts: None known. 
See Also: Floppy INT 1Eh, Hard Disk INT 41h 
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INTERRUPT 13h - Function 15h 


GET DISK TYPE 
Purpose: Determine the type of the specified drive. 
Available on: XT with BIOS dated 01/10/86 or Restrictions: none. 
later, XT286, AT, and PS/2 
machines. 
Registers at call: Return Registers: 
AH = 15h CF clear if successful 
DL = drive number (bit 7 set for hard disk) AH = type code: 


00h no such drive 
01h floppy without change-line support 
02h floppy with change-line support 
03h hard disk 
CX:DX = number of 512-byte sectors 
CF set on error 
AH = status (Table 6-1) 
Conflicts: None known. 
See Also: Functions 16h and 17h, SCSI Function 19h 


INTERRUPT 13h - Function 18h 
SET MEDIA TYPE FOR FORMAT 


Purpose: Specify drive parameters to be used when formatting a disk. 


Available on: AT model 3x9, XT2, XT286, PS/2 Restrictions: none. 
machines. 
Registers at call: Return Registers: 
AH = 18h AH = status 
DL = drive number 00h requested combination supported 
CH = lower 8 bits of number of tracks Oth function not available 
CL = sectors per track (bits 0-5) OCh not supported or drive type unknown 
top 2 bits of number of tracks (bits 6,7) 80h there is no disk in the drive 


ES:DI -> 11-byte parameter table 
Conflicts: Future Domain SCSI Controller. 
See Also: Functions 05h, 07h, and 17h 


INTERRUPT 13h - Function 20h 
Western Digital “Super BIOS" - UNKNOWN FUNCTION 


Purpose: unknown. No information is available on this call. 


Available on: Systems equipped with appropriate Restrictions: unknown. 
Western Digital controllers. 

Registers at call: Return Registers: unknown, 

AH = 20h 


other registers, if any, unknown. 
Details: Seems to return some kind of status. 
Conflicts: QCACHE - Dismount. 


INTERRUPT 4Eh 

TI Professional PC - DISK /0 

Purpose: Used instead of INT 13h on the TI Professional PC. 

Available on: TI Professional PC only. Restrictions: none. 

Registers at call: Same as INT 13h. Return Registers: Same as INT 13h, 
Conflicts: None known. 

See Also: INT 13h 


Floppies 
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The functions described in this section are used by floppy disk operations only. 


INTERRUPT 13h - Function 05h 

Floppy Diskette: FORMAT TRACK 

Purpose: Prepare a floppy diskette for data storage. 
Available on: All machines. 


Registers at call: 

AH = 05h 

AL = number of sectors to format 

CH = track number 

DH = head number 

DL = drive number 

ES:BX -> address field buffer (Table 6-2) 


Restrictions: On AT or later, function 17h must be 
called first. 

Return Registers: 

CF set on error 

CF clear if successful 

AH = status (Table 6-1) 


Details: The number of sectors per track is read from the Diskette Parameter Table pointed at by INT 1Eh. 


Conflicts: Fixed Disk - Format Track. 


See Also: Hard Disk Function 05h, Functions 17h and 18h, INT 1Eh 


Table 6-2. Format of address field buffer entry (one per sector in track): 


Offset Size Description 

00h BYTE track number 

Olh BYTE head number (0-based) 
02h BYTE sector number 

03h BYTE sector size: 


00h 128 bytes 
Olh 256 bytes 
02h 312 
03h 1024 


INTERRUPT 13h - Function 16h 
DETECT DISK CHANGE 


Purpose: Determine whether a removable diskette has been changed, 


Available on: XT with BIOS dated 01/10/86 or 
later, XT286, AT, and PS/2 
machines. 

Registers at call: 

AH = 16h 

DL = drive number 


Restrictions: none. 


Return Registers: 
CF clear if change line inactive 
AH = 00h (disk not changed) 
CF set if change line active 
AH = 06h change line active or not supported 
80h drive not ready or not present 


Details: Function 15h should be called first to determine whether the desired drive supports a change line. 


Conflicts: None known. 
INTERRUPT 13h - Function 17h 
SET DISK TYPE FOR FORMAT 


Purpose: Prepare to format floppy diskette. 
Available on: AT and PS/2 machines. 


Restrictions: none. 
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Registers at call: Return Registers: 

AH = 17h CF set on error 

AL = format type: CF clear if successful 
Olh = 320/360K. disk in 360K drive AH = status (Table 6-1) 


02h = 320/360K disk in 1.2M drive 
03h = 1.2M disk in 1.2M drive 
04h = 720K disk in 720K drive 
DL = drive number 
Details: This function does not handle 1.44M drives; function 18h should be used instead when formatting diskettes 
ina 1.44M drive. 
Conflicts: None known. 
See Also: Functions 15h and 18h 


INTERRUPT 1Eh 
SYSTEM DATA - DISKETTE PARAMETERS 


Purpose: Not an interrupt. This vector points to the default floppy disk parameter table (Table 6-3), which is located 
at FOO0Oh:EFC7h for 100 percent compatible BIOSes, 

Available on: All machines. Restrictions: none. 

Registers at call: n/a Return Registers: n/a 

Conflicts: None known. 

See Also: INT 13h Function OFh, Hard Disk INT 41h 


Table 6-3. Format of diskette parameter table: 


Offset Size Description 
00h BYTE first specify byte 
bits 7-4: step rate 
3-0: head unload time (OFh = 240 ms) 
Olh BYTE second specify byte 
bits 7-1: head load time (01h = 4 ms) 
0: non-DMA mode (always 0) 


02h BYTE delay until motor turned off (in clock ticks) 
03h BYTE bytes per sector: 
00h = 128 
Olh = 256 
02h = 512 
03h = 1024 
04h BYTE sectors per track 
05h BYTE length of gap between sectors (2Ah for 5.25", 1Bh for 3.5") 
06h BYTE data length (ignored if bytes-per-sector field is nonzero) 
O7h BYTE gap length when formatting (50h for 5.25", 6Ch for 3.5") 
08h BYTE format filler byte (default F6h) 
09h BYTE head settle time in milliseconds 
OAh BYTE motor start time in 1/8 seconds 
INTERRUPT 40h 


ROM BIOS DISKETTE HANDLER RELOCATED BY HARD DISK BIOS 


Purpose: Permit floppy disk support to be hooked independently of fixed disk support. 

Available on: All machines, Restrictions: Hard disk must be installed. 

Registers at call: Same as INT 13h. Return Registers: Same as INT 13h. 

Details: INT 40h was originally used to allow the hard disk BIOS on an IBM PC or XT hard disk controller to chain 
to the floppy disk code in the system's ROM BIOS. Although IBM ATs and later support hard disks in the ROM 
BIOS, the INT 40h functionality was kept for backward compatibility. 

Conflicts: None known. 

See Also: INT 13h, 4+Power INT 63h 
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INTERRUPT 63h 
4+Power FLOPPY CONTROLLER - ORIGINAL INT 13h/INT 40h 


Purpose: The "4+Power" quad floppy controller BIOS hooks INT 13h (or INT 40h if INT 13h has been moved 
there) and places the old value here. 


Available on: All machines. Restrictions: 4+Power floppy controller must be 
installed, 

Registers at call: See INT [3h. Return Registers: See INT 13h. 

Conflicts: Adaptec and OMTI controllers - DRIVE 0 DATA, Oracle SQL Protected Mode Executive (chapter 9). 

Hard Disks 


The functions described in this section are used by fixed/hard disk operations only. 


INTERRUPT 13h - Function 05h 
Fixed Disk: FORMAT TRACK 


Purpose: Prepare a fixed disk for data storage. 


Available on: All machines with fixed disk Restrictions: For XT-type controllers on on AT or 
installed. later, Function OFh should be called 
first. 
Registers at call: Return Registers: 
AH =05h AH = status code (Table 6-1) 


AL = interleave value (XT-type controllers only) 
ES:BX = 512-byte format buffer: 
The first 2**( sectors/ track) bytes contain 
FN for each sector: 
F = 00h for good sector, 
80h for bad sector 

N = sector number 
CH = cylinder number (bits 8,9 in high bits of CL) 
CL = high bits of cylinder number (bits 7,6) 
DH = head 
DL = drive 
Details: The AWARD AT BIOS has been extended to handle more than 1024 cylinders by placing bits 10 and 11 of 
the cylinder number into bits 6 and 7 of DH. The AMI BIOS apparently also follows this convention. 
Conflicts: Floppy - Format Track. 
See Also: Functions 06h, 07h, OFh, [8h, and 1Ah 


INTERRUPT 13h - Function 06h 
Fixed Disk: FORMAT TRACK AND SET BAD SECTOR FLAGS 


Purpose: Prepare a fixed disk for data storage and note "bad sector” information. 


Available on: XT and Portable only. Restrictions: none. 
Registers at call: Return Registers: 
AH = 06h AH = status code (Table 6-1) 


AL = interleave value 

CH = cylinder number (bits 8,9 in high bits of CL) 

CL = sector number 

DH = head 

DL = drive 

Details: The AWARD AT BIOS has been extended to handle more than 1024 cylinders by placing bits 10 and 11 of 
the cylinder number into bits 6 and 7 of DH. The AMI BIOS apparently also follows this convention. 

Conflicts: None known. 
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INTERRUPT 13h - Function 07h 


Fixed Disk: FORMAT DRIVE STARTING AT GIVEN TRACK 
Purpose: Prepare only part of a fixed disk for data storage. 


Available on: XT and Portable only. 
Registers at call: 
AH = 07h 


Restrictions: none. 
Return Registers: 
AH = status code (Table 6-1) 


AL = interleave value (XT only) 

ES:BX = 512-byte format buffer (see Function 05h) 

CH = cylinder number (bits 8,9 in high bits of CL) 

CL = sector number 

DH = head 

DL = drive 

Details: The AWARD AT BIOS has been extended to handle more than 1024 cylinders by placing bits 10 and 11 of 
the cylinder number into bits 6 and 7 of DH. The AMI BIOS apparently also follows this convention. 

Conflicts: None known. 

See Also: Function 1Ah 


INTERRUPT 13h - Function 09h 
INITIALIZE CONTROLLER WITH DRIVE PARAMETERS 


Purpose: Re-initialize fixed disk controller. 
Available on: AT and PS/2 models. 
Registers at call: 

AH = 09h 

DL = drive (80h for first, 81h for second) 


Restrictions: none. 

Return Registers: 

CF clear if successful 

CF set on error 

AH = status (Table 6-1) 

Details: On the PC and XT, this function uses the parameter table pointed at by INT 41h. On the AT and later, this 
function uses the parameter table pointed at by INT 41h if DL=80h, and the parameter table pointed at by INT 46h if 
DL=8 1h. 

Conflicts: None known, 

See Also: INT 41h, INT 46h 


INTERRUPT 13h - Function 0Ah 
READ LONG SECTOR(S) 


Purpose: This function reads in four to seven bytes of error-correcting code along with each sector's worth of 
information. 
Available on: AT and later. 
Registers at call: 
AH = 0Ah 
AL = number of sectors 
CH = low eight bits of cylinder number 
CL = sector number (bits 5-0) 
high two bits of cylinder number 
(bits 7-6) 
DH = head number 
DL = drive number (80h = first, 81h = second) 
ES:BX -> data buffer 
Details: Data errors are not automatically corrected, and the read is aborted after the first sector with an ECC error. 
Used for diagnostics only on PS/2 systems. 
Conflicts: None known. 
See Also: Function OBh, general Function 02h 


Restrictions: none. 

Return Registers: 

CF clear if successful 

CF set on error 

AH & status (Table 6-1) 

AL = number of sectors transferred 
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INTERRUPT 13h - Function 0Bh 


WRITE LONG SECTOR(S) 
Purpose: Write one or more sectors together with explicit error-correcting information. Used for diagnostics only on 
PS/2 systems. 
Available on: AT and later. Restrictions: none. 
Registers at call: Return Registers: 
AH = 0Ah CF clear if successful 
AL = number of sectors CF set on error 
CH = low eight bits of cylinder number AH = status (Table 6-1) 
CL = sector number (bits 5-0) AL = number of sectors transferred 
high two bits of cylinder number 
(bits 7-6) 


DH = head number 

DL = drive number (80h = first, 81h = second) 

ES:BX -> data buffer 

Details: Each sector's worth of data must be followed by four to seven bytes of error-correction information. 
Conflicts: None known. 

See Also: Function 0Ah, general Function 03h 


INTERRUPT 13h - Function 0Ch 


SEEK TO CYLINDER 
Purpose: Position fixed disk to specified cylinder. 
Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AH =0Ch CF set on error 
CH = low eight bits of cylinder number CF clear if successful 
CL = sector number (bits 5-0) AH = status (Table 6-1) 
high two bits of cylinder number 
(bits 7-6) 


DH = head number 

DL = drive number (80h = first, 81h = second) 
Conflicts: None known. 

See Also: Function OAh, general Functions 00h and 02h 


INTERRUPT 13h - Function 0Dh 


RESET HARD DISKS 

Purpose: Reinitializes the hard disk controller, resets the specified drive's parameters, and recalibrates the drive's 
heads (seek to track 0). 

Available on: All machines with fixed disks. Restrictions: Not for PS/2 ESDI drives. 

Registers at call: Return Registers: 

AH = 0Dh CF set on error 

DL = drive number (80h = first, 81h = second) CF clear if successful 


AH = status (Table 6-1) 


Conflicts: None known. 
See Also: Function 00h, INT 21h Function 0Dh (chapter 8) 


INTERRUPT 13h - Function 0Eh 

READ SECTOR BUFFER 

Purpose: Transfers controller's sector buffer. No data is read from the drive. 
Available on: XT only. Restrictions: none. 
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Registers at call: Return Registers: 

AH = 0Eh CF set on error 

DL = drive number (80h = first, 81h = second) CF clear if successful 
ES:BX -> buffer AH = status code (Table 6-1) 


Details: Used for diagnostics only on PS/2 systems. 
Conflicts: None known. 
See Also: Function 0Ah 


INTERRUPT 13h - Function OFh 


WRITE SECTOR BUFFER 

Purpose: Initializes controller's sector buffer. Does not write data to the drive. 

Available on: XT only. Restrictions: none. 
Registers at call: Return Registers: 

AH = 0Fh CF set on error 

DL = drive number (80h = first, 81h = second) CF clear if successful 
ES:BX -> buffer AH = status code (Table 6-1) 


Details: Should be called before formatting to initialize an XT-type controller's sector buffer. Used for diagnostics 
only on PS/2 systems, 
Conflicts: None known, 
See Also: Function OBh 


INTERRUPT 13h - Function 10h 





CHECK IF DRIVE READY 

Purpose: Determine whether fixed disk is ready for operation. 

Available on: All machines with fixed disk. Restrictions: none. 
Registers at call: Return Registers: 
AH = 10h CF set on error 

DL = drive number (80h = first, 81h = second) CF clear if successful 


AH = status (Table 6-1) 
Conflicts: None known. 


INTERRUPT 13h - Function 11h 


RECALIBRATE DRIVE 

Purpose: Cause hard disk controller to seek the specified drive to cylinder 0. 
Available on: All machines with fixed disk. Restrictions: none. 
Registers at call: Return Registers: 
AH = 11h CF set on error 

DL = drive number (80h = first, 81h = second) CF clear if successful 


AH = status (Table 6-1) 
Conflicts: None known. 
See Also: Functions 00h, OCh, and 19h 


INTERRUPT 13h - Function 12h 
CONTROLLER RAM DIAGNOSTIC 


Purpose: Perform built-in RAM diagnostics of hard disk controller, 


Available on: XT and PS/2 models. Restrictions: none. 
Registers at call: Return Registers: 
AH= [2h CF set on error 

DL = drive number (80h = first, 8Lh = second) CF clear if successful 


AH = status code (Table 6-1) 
Conflicts: Future Domain SCSI Controller. 
See Also: Functions 13h and 14h 
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INTERRUPT 13h - Function 13h 


DRIVE DIAGNOSTIC 

Purpose: Perform built-in diagnostics of hard disk controller. 

Available on: XT and PS/2 models. Restrictions: none. 
Registers at call: Return Registers: 
AH = 13h CF set on error 

DL = drive number (80h = first, 81h = second) CE clear if successful 


AH = status code (Table 6-1) 


Conflicts: None known. 
See Also: Functions 12h and 14h 


INTERRUPT 13h - Function 14h 
CONTROLLER INTERNAL DIAGNOSTIC 


Purpose: Perform built-in internal diagnostics of hard disk controller. 


Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AH = 14h CF set on error 


CF clear if successful 

AH = status code (Table 6-1) 
Conflicts: None known. 
See Also: Functions 12h and 13h 


INTERRUPT 13h - Function 19h 

PARK HEADS 

Purpose: Move the drive heads to a safe position for powerdown and transport. On many drives, the heads are 
automatically locked in place on seeking to the parking position. 


Available on; XT286 and PS/2 machines. Restrictions: none. 
Registers at call: Return Registers: 

AH = 19h CF set on error 

DL = drive AH = status (Table 6-1) 


Conflicts: Future Domain SCSI Controller. 
See Also: Function 11h 


INTERRUPT 2Fh - Function F7h, Subfunction 00h 
Multiplex - AUTOPARK.COM - INSTALLATION CHECK 


Purpose: Determine whether AUTOPARK TSR has been installed, AUTOPARK.COM is a resident hard disk 
parker by Alan D. Jones, 


Available on: All machines. Restrictions: DOS versions prior to 3.0 must verify 
that interrupt vector is not 0000:0000 
before using INT 2Fh. 

Registers at call: Return Registers: 

AX = F700h AL = 00h not installed 

FFh installed 


Conflicts: None known. 


INTERRUPT 2Fh - Function F7h, Subfunction 01h 
Multiplex - AUTOPARK.COM - SET PARKING DELAY 


Purpose: Establish timeout interval before disk parking is done automatically. 


Available on: All machines. Restrictions: AUTOPARK TSR must be installed. 
Registers at call: Return Registers: n/a 
AX = F701h 


BX:CX = 32-bit count of 55ms timer ticks 
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Conflicts: None known. 


INTERRUPT 41h 
SYSTEM DATA - HARD DISK 0 PARAMETER TABLE 


Purpose: Not a procedure; this vector contains a far pointer to the parameter table (Table 6-4) for Hard Disk 0. 
Available on: All machines, Restrictions: none. 

Details: The default parameter table array is located at FO00h:E401h in 100 percent compatible BIOSes. 
Conflicts: None known. 

See Also: INT 13h Function 09h, INT 46h, Diskette INT 1Eh 


Table 6-4. Format of fixed disk parameters: 


Offset Size Description 

00h WORD number of cylinders 

02h BYTE number of heads 

03h WORD starting reduced write current cylinder {XT only, 0 for others) 
05h WORD starting write precompensation cylinder number 

07h BYTE maximum ECC burst length (XT only) 

08h BYTE control byte: 


bits 0-2: drive option (XT only, 0 for others) 

bit 3: set if more than 8 heads (AT and later only) 

bit 4: always 0 

bit 5: set if manufacturer's defect map on max cylinder+1 
(AT and later only) 

bit 6: disable ECC retries 

bit 7: disable access retries 


09h BYTE standard timeout (XT only, 0 for others) 

0Ah BYTE formatting timeout (XT only, 0 for others) 

OBh BYTE timeout for checking drive (XT only, 0 for others) 

0Ch WORD cylinder number of landing zone (AT and later only) f 
OEh BYTE number of sectors per track (AT and later only) i 
OFh BYTE reserved 

INTERRUPT 46h 


SYSTEM DATA - HARD DISK 1 DRIVE PARAMETER TABLE 


Purpose: Not a procedure; this vector contains a far pointer to the parameter table (Table 6-4) for Hard Disk 1. 
Available on: All machines, Restrictions: none. 

Conflicts: None known, 

See Also: INT 13h Function 09h, INT 41h 


Special Controllers 
The functions described in this section include those used by EDSI, SCSI, and other advanced interfaces. 


INTERRUPT 13h - Function 12h 
Future Domain - STOP SCSI DISK 


Purpose: Terminate disk operation ("park disk"). 


Available on: Machines with Future Domain SCSI Restrictions: none. 
controller present. 

Registers at call: Return Registers: 

AH= 12h CF set on error 

DL = hard drive ID AH = status code (Table 6-1) 


Details: Available on at least the TMC-870 8-bit SCSI controller BIOS v6.0A. If the given drive is a SCSI device, 
the SCSI Stop Unit command is sent and either "Disk prepared for shipping" or "Disk Stop command failed" is 
displayed. 

Conflicts: Hard Disk - Controller RAM Diagnostic. 
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INTERRUPT 13h - Function 18h 
Future Domain - GET SCSI CONTROLLER INFORMATION 


Purpose: Obtain information about specified SCSI drive. 


Available on: Machines with Future Domain SCSI Restrictions: none. 
controller present. 
Registers at call: Return Registers: 
AH = 18h CF set on error 
DL = hard drive ID AH = status code (Table 6-1) 


CF clear if successful 

AX = 4321h (magic number???) 

BH = number of SCSI drives connected 

BL = SCSI device number for specified drive 

CX = 040Ah (magic number???) 
Details: This call also sets an internal flag (non-resettable) which prevents some controller messages from being 
displayed and allows writes to removable devices. 
Conflicts: Disk - Set Media Type for Format. 
See Also: Future Domain Function 1Bh 


INTERRUPT 13h - Function 19h 
Future Domain » REINITIALIZE SCSI DRIVE 


Purpose: Reinitializes specified SCSI drive. 


Available on: Machines with Future Domain SCSI Restrictions: none. 
controller present. 
Registers at call: Return Registers: 
AH = 19h CF set on error 
DL = hard drive ID AH = status code (Table 6-1) 


CF clear if successful 

AH = disk type (03h = fixed disk) 

CX:DX = number of 512-byte sectors 
Details: Sends a SCSI Read Capacity command to get the number of logical blocks and adjusts the result for 512- 
byte sectors. Displays either "Error in Read Capacity Command" or "nnn Bytes per sector" (nnn=256 or 512, the 
only sizes supported in the translation code). This function should probably be called when a removable device has 
its media changed. Returns the same values as Function 15h. 
Conflicts: Fixed Disk - Park Heads. 
See Also: Future Domain Function 1Ah, general Function 15h 


INTERRUPT 13h - Function 1Ah 


ESDI FORMAT UNIT 

Purpose: Prepare ESDI fixed disk for data storage. 

Available on: PS/2 machines. Restrictions: none. 
Registers at call: Return Registers: 
AH=1Ah CF set on error 

AL = defect table count AH = status (Table 6-1) 


CL = format modifiers: 
bit 4: generate periodic interrupt 
bit 3: perform surface analysis 
bit 2: update secondary defect map 
bit 1: ignore secondary defect map 
bit 0: ignore primary defect map 
DL = drive 
ES:BX -> defect table 
Details: If periodic interrupt is selected, INT 15h Function OFh is called after each cylinder is formatted. 





| 
| 
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Conflicts: Future Domain SCSI Controller, 
See Also: Function 07h, INT 15h Function OFh 


INTERRUPT 13h - Function 1Ah 
Future Domain - GET SCSI PARTIAL MEDIUM CAPACITY 


Purpose: Determine media capacity for SCSI drive. 
Available on: Machines with Future Domain SCSI 
controller present. 

Registers at call: 

AH=1Ah 

CH = track (bits 8, 9 in high bits of CL) 

CL = sector (Oth to number of sectors/track for 
drive) 

DH = head 

DL = hard drive ID 


Restrictions: none. 


Return Registers: 

CF set on error 

AH = status code (Table 6-1) 

CX:DX = logical block number of last quickly- 
accessible block after given block 


Details: Sends SCSI Read Capacity command with the PMI bit set to obtain the logical block address of the last 
block after which a substantial delay in data transfer will be encountered (usually the last block on the current 
cylinder). No translation to 512 byte sectors is performed on the result if data is stored on the disk in other than 512 


byte sectors. 
Conflicts: ESDI Fixed Disk. 
See Also: Function 15h, Future Domain Function 19h 


INTERRUPT 13h - Function 1Bh 
GET ESDI MANUFACTURING HEADER 


Purpose: Get list of manufacturing defects for the specified drive. 


Available on: Systems with ESDI fixed disk. 

Registers at call: 

AH = IBh 

AL = number of record 

DL = drive 

ES:BX -> buffer for manufacturing header 
(defect list) 


Restrictions; none. 
Return Registers: 
CF set on error 

AH * status 


Details: The manufacturing header format (Defect Map Record format) can be found in the IBM 70MB, 115MB 


Fixed Disk Drives Technical Reference. 
Conflicts: Future Domain SCSI Controller, 


INTERRUPT 13h - Function 1Bh 
Future Domain - GET POINTER TO SCSI DISK INFO BLOCK 


Purpose: Return pointer to SCSI information block, 

Available on: Machines with Future Domain SCSI 
controller present. 

Registers at call: 

AH = 1Bh 

DL = hard drive ID 


Restrictions: none. 


Return Registers: 
CF set on error 
AH = status code (Table 6-1) 
CF clear if successful 
ES:BX -> SCSI disk information block 
(Table 6-5) 


Details: Also sets a non-resettable flag which prevents some controller messages from being displayed. 


Conflicts: Get ESDI Manufacturing Header. 
See Also: Future Domain Functions 18h and 1Ch 


Low-Level Disk /O 6-15 


Table 6-5. Format of SCSI disk information block: 


Offset Size Description 
00h BYTE drive physical information: 
bit 0: unknown. 
bit 1: device uses parity 
bit 2: 256 bytes per sector instead of 512 
bit 3: don't have capacity yet??? 
bit 4: disk is removable 
bit 5: logical unit number is not present 


Oth WORD translated number of cylinders 

03h BYTE translated number of heads 

04h BYTE translated number of sectors per track (17, 34, or 63) 
05h BYTE drive address: 


bits 0-2: logical unit number 
bits 3-5: device number 


06h BYTE Olh at initialization 

07h BYTE sense code byte 00h, or extended sense code byte OCh 
08h BYTE 00h 

09h BYTE 00h or extended sense code byte 02h (sense key) 

OAh BYTE 00h 

OBh 10 BYTEs copy of Command Descriptor Block (CDB) 

15h DWORD _ translated number of sectors on device 


INTERRUPT 13h - Function 1Ch 
Future Domain - GET POINTER TO FREE SCSI CONTROLLER RAM 


Purpose: Obtain address of first byte of free RAM in controller. 





Available on: Machines with Future Domain SCSI Restrictions: none. 
controller present. 
Registers at call: Return Registers: 
AH=1Ch CF set on error 
DL = hard drive ID (any valid SCSI hard disk) AHL = status code (Table 6-1) 


CF clear if successful 
ES:BX -> first byte of free RAM on controller 

Details: The Future Domain TMC-870 contains 1024 bytes of RAM at offsets 1800h to 1BFFh on-board the 
controller for storing drive information and controller status; ES:BX points to the first byte available for other uses. 
ES contains the segment at which the controller resides; the controller's two memory-mapped I/O ports are at offsets 
1C00h and 1B00h, 
Conflicts: ESDI Fixed Disk, 
See Also: Future Domain Function 1Bh 


INTERRUPT 13h - Function 1Ch, Subfunction OAh 
GET ESDI DEVICE CONFIGURATION 


Purpose: Determine configuration of ESDI fixed disk. 


Available on: PS/2 systems with ESDI fixed disk. Restrictions: none. 
Registers at call: Return Registers: 
AX = 1C0Ah CF set on error 

DL = drive AH = status 


ES:BX -> buffer for device configuration 
(drive physical parameters) 
Details: The device configuration format can be found in the IBM ESDI Fixed Disk Drive Adapter/A Technical 
Reference. 
Conflicts: Future Domain - Get Pointer to Free SCSI Controller RAM. 


1 
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INTERRUPT 13h - Function 1Ch, Subfunction OBh 
GET ESD! ADAPTER CONFIGURATION 


Purpose: Read adapter configuration into buffer, 


Available on: PS/2 systems with ESDI fixed disk. Restrictions: none. 
Registers at call: Return Registers: 
AX = 1COBh CF set on error 
ES:BX -> buffer for adapter configuration AH = status 


Conflicts: Future Domain - Get Pointer to Free SCSI Controller RAM, 
See Also: Function 1COCh 


INTERRUPT 13h - Function 1Ch, Subfunction 0Ch 
GET ESD] POS INFORMATION 


Purpose: Read Programmable Option Select information into buffer. 


Available on: PS/2 systems with ESDI fixed disk. Restrictions: none. 
Registers at call: Return Registers: 
AX = 1C0Ch CF set on error 
ES:BX -> POS information AH = status 


Conflicts: Future Domain - Get Pointer to Free SCSI Controller RAM, 
See Also: ESDI Function 1Ch Subfunction OBh 


INTERRUPT 13h - Function 1Ch, Subfunction 0Eh 
ESD! - TRANSLATE RBA TO ABA 


Purpose: Convert relative block address format to absolute block address format. 


Available on: PS/2 systems with ESDI fixed disk. Restrictions: none. 
Registers at call: Return Registers: 
AX = 1COEh CF set on error 

CH = low 8 bits of cylinder number AH = status 


CL = sector number, high two bits of cylinder 
number in bits 6 and 7 
DH = head number 
DL = drive number 
ES:BX -> ABA number 
Details: ABA (absolute block address) format can be found in IBM ESDI Adapter Technical Reference by using its ! 
Device Configuration Status Block. ; 
Conflicts: Future Domain - Get Pointer to Free SCSI Controller RAM. 


INTERRUPT 13h - Function 70h 
Priam EDVR.SYS DISK PARTITIONING SOFTWARE 


Purpose: nnknown. 


Available on: All machines using Priam software. Restrictions: none. 
Registers at call: Return Registers: unknown. 
AH =70h 


Others, if any, unknown. 

Details: Priam's EDISK.EXE (FDISK replacement) and EFMT.EXE (low-level formatting program) make this call, 
presumably to EDVR.SYS (the partitioning driver). 

Conflicts: None known. 

See Also: Function ADh 


INTERRUPT 13h - Function ADh 
Priam HARD DISK CONTROLLER 


Purpose: unknown. 
Available on: All machines using Priam controller. Restrictions: none. 
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Registers at call: Return Registers: unknown. 


AH = ADh 
Others, if any, unknown. 
Details: This call is made from Priam’s EFMT.EXE (low-level formatter), probably to check the ROM type on the 


controller for their hard disk kits. 
Conflicts: None known. 
See Also: Function 70h 


INTERRUPT 13h - Function EEh 
SWBIOS - SET 1024 CYLINDER FLAG 


Purpose: Sets flag so that the following INT 13h call will interpret the desired cylinder number as 1024 more than 
the specified cylinder. The flag is cleared by all INT 13h calls except this one. 


Available on: All machines using SWBIOS. Restrictions: none. 
Registers at call: Return Registers: 
AH = EEh CF clear 

DL = drive number (80h, 81h) AH = 00h 


Details; SWBIOS is a TSR by Ontrack Computer Systems; Disk Manager, HyperDisk v4.01+, and PC-Cache v6.0 
also support this call. 

Conflicts: HyperDisk 4.01. 

See Also: SWBIOS Functions F9h and FEh 


INTERRUPT 13h - Function F9h 
SWBIOS - INSTALLATION CHECK 


Purpose: Determines whether SWBIOS is present in system, SWBIOS is a TSR by Ontrack Computer Systems. 


Available on; All machines. Restrictions: none. 
Registers at call: Return Registers: 
AH = F9h CF clear 
DL = drive number (80h, 81h) DX = configuration word 
bit 15 set if other SWBIOS extensions 
available 


CF set on error 
Details: Disk Manager also supports these calls. 
Conflicts: None known, 
See Also: SWBIOS Function BEh 


INTERRUPT 13h - Function FEh 
SWBIOS - GET EXTENDED CYLINDER COUNT 


Purpose: Read size of drive larger than 1024 cylinders. 


Available on: All machines with SWBIOS Restrictions: none. 
installed. 
Registers at call: Return Registers: 
AH = FEh CF clear 
DL = drive number (80h, 81h) DX = number of cylinders beyond 1024 on drive 


Details: SWBIOS is a TSR by Ontrack Computer Systems; Disk Manager also supports these calls. 
Standard INT 13h Function O8h will return a cylinder count truncated to 1024. BIOS without this extension 
would return count modulo 1024. 
Conflicts: None known. 
See Also: SWBIOS Function EEh 


INTERRUPT 4Bh 
Common Access Method SCSI interface (draft revision 1.9) 


Purpose: Standardize methods for communicating with SCSI devices. 
Available on: All machines. Restrictions: CAM SCSI interface must be present. 
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Details: The CAM committee moved the interface to INT 4Fh after revision 1.9 to avoid conflicting with the IBM 
SCSI interface and the Virtual DMA specification. It is not known whether any drivers actually implemented this 
interface on INT 4Bh instead of INT 4Eh. 

The installation check for the driver is the string "SCSI_CAM" eight bytes past the INT 4Bh handler. 
Conflicts: IBM SCSI interface, Virtual DMA (chapter 12). 
See Also: INT 4Fh 


INTERRUPT 4Bh - Function 80h 


IBM SCSI interface 

Purpose: Permit access to IBM SCSI disks. 

Available on: IBM PS/2 models with IBM SCSI Restrictions: none. 
controllers, 

Registers at call: Return Registers: unknown. 

AH = 80h 


additional registers unknown. 
Conflicts: Common Access Method revision 1.9 


INTERRUPT 4Fh - Function 8100h 
Common Access Method SCSI interface - SEND CCB TO XPT/SIM 


Purpose: Execute commands on SCSI devices in a vendor-independent manner, 


Available on: Machines equipped with a SCSI host Restrictions: SCSI_ interface conforming to CAM 
adaptor revision 2.3 or higher must be installed 

Registers at call: Return Registers: 

AX = 8100h AH = status 

ES:BX -> CAM Control Block (Table 6-6) 00h successful 


Oth invalid CCB address (0000h:0000h) 
Details: The SCSI Interface Module (SIM) may complete the requested function and invoke the completion callback 
function before this call returns. 
Conflicts: Z100 Slave 8259 (chapter 2) 
See Also: Function 8200h, INT 4Bh 


Table 6-6. Format of CAM Control Block: 


Offset Size Description 

00h DWORD physical address of this CCB 
04h WORD CAM control block length 
06h BYTE function code (Table 6-7) 
07h BYTE CAM status (Table 6-8) 

08h BYTE SCSI status 

09h BYTE path ID (FFh = XPT) 

OAh BYTE target ID 

OBh BYTE logical unit number 

0Ch BYTE CAM flags 


bits 7-6: direction 

00 reserved 

01 in 

10 out 

11 no data transfer 
bit 5: disable autosense 
bit 4: scatter/gather 
bit 3: disable callback on completion 
bit 2: linked CDB 
bit 1: tagged queue action enable 
bit 0: CDB is a pointer 
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Table 6-6. Format of CAM Control Block (continued) 


Offset Size 
0Dh BYTE 
OEh BYTE 
OFh BYTE 
-~function 02h 

10h DWORD 
14h BYTE 
-«-function 03h 

10h BYTE 
11h BYTE 
Offset Size 
12h BYTE 
(3h BYTE 
14h WORD 


Description 
CAM flags 
bit 7: disable disconnect 


bit 6: initiate synchronous transfers mutually 
bit 5: disable synchronous transfers /exclusive 


bit 4: SIM queue priority 
1 head insertion 
0 tail insertion (normal) 
bit 3: SIM queue freeze 
bit 2: engine synchronize 
bits 1-0: reserved 
CAM adaress flags 


bit 7: SG list/data (0 = host, | = engine) 
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bit 6: CDB pointer (bits 6-1: O=virtual addr,1=phys addr) 


bit 5: SG list/data 
bit 4: sense buffer 
bit 3: message buffer 
bit 2: next CCB 
bit 1: callback on completion 
bit 0: reserved 

target-mode flags 
bit 7: data buffer valid 
bit 6: status valid 
bit 5: message buffer valid 
bit 4: reserved 
bit 3: phase-cognizant mode 
bit 2: target CCB available 
bit 1: disable autodisconnect 
bit 0: disable autosave/restore 


pointer to 
peripheral 


36-byte buffer for inquiry data or 0000h:0000h 
device type of target logical unit number 


version number (00h-07h prior to rev 1.7, 08h = rev 1.7, 


09h-FFh = rev no, ic, 23h = rev 2.3 
SCSI capabilities 
bit 7: modify data pointers 
bit 6: wide bus (32 bits) 
bit 5: wide bus (16 bits) 
bit 4: synchronous transfers 
bit 3: linked commands 
it 2; reserved 
it 1: tagged queueing 
bit 0: soft reset 
Description 
target mode support 
bit 7: processor mode 
bit 6: phase-cognizant mode 
its 5-0; reserved 
miscellaneous flags 





bit 6: removables not included in scan 
bit 5: inquiry data not kept by XPT 
bit 4-0: reserved 

engine count 


16h 14BYTEs vendor-specific data 


it 7: scanned high to low instead of low to high 
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Table 6-6. Format of CAM Control Block (continued) 


24h DWORD 
28h DWORD 


2Ch BYTE 
2Dh BYTE 
2Eh 2 BYTEs 
30h 16 BYTEs 
40h 16 BYTEs 
50h 4 BYTEs 


size of private data area 
asynchronous event capabilities 
bits 31-24: vendor-specific 
bits 23-8: reserved 


bit 7: new devices found during rescan 


bit 6: SIM module deregistered 
bit 5: SIM module registered 
bit 4: sent bus device reset to target 
bit 3: SCS] AEN 
bit 2: reserved 
bit 1: unsolicited reselection 
bit 0: unsolicited SCSI bus reset 
highest path ID assigned 
SCSI device ID of initiator 
reserved 
SIM vendor ID 
HBA (host bus adaptor) vendor ID 
operating-system dependant usage 


~«functions 00h,04h,11h,12h 


no additional fields 
-function 05h 





10h DWORD 
14h DWORD 
18h DWORD 
iCh BYTE 
--function 06h 

10h BYTE 
functions 10h,13h 
10h DWORD 
--function 20h 

10h WORD 
12h BYTE 
13h BYTE 
14h DWORD 
function 21h 

10h DWORD 
14h 4 BYTEs 
18h DWORD 
1Ch DWORD 
20h DWORD 
24) DWORD 
28) DWORD 
2Ch 2 BYTEs 
2Eh WORD 
30h DWORD 
34h DWORD 
38h DWORD 


asynchronous event enables (see function 03h) 


pointer to asynchronous callback routine 
pointer to peripheral driver buffer 
size of peripheral buffer 


peripheral device type of target 
pointer to CCB to be aborted 


engine number 
engine type 
00h buffer memory 
Oth lossless compression 
02h lossy compression 
03h encryption 
engine algorithm ID 
00h vendor-unique 
Olh LZ1 variation 1 (STAC) 
02h LZ2 variation | (HP DCZL) 
03h LZ2 variation 2 (Infochip) 
engine memory size 


pointer to peripheral driver 

reserved 

OS-dependent request-mapping info 
address of completion callback routine 
pointer to scatter/gather list or data buffer 
length of data transfer 

pointer to engine buffer data 

teserved 

number of scatter/gather entries 
maximum destination data length 
length of destination data 

source residual length 
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Table 6-6. Format of CAM Control Block (continued) 














Offset Size Description 
--function 2th (continued) 
3Ch 12BYTEs reserved 
48h DWORD OS-dependent timeout value 
4Ch 4BYTEs reserved 
50h WORD engine number 
52 WORD vendor-unique flags 
34 4BYTEs _ reserved 
58 NBYTEs _ private data area for SIM 
--function 30h 
Oh WORD group 6 vendor-unique CDB length 
12) WORD group 7 vendor-unique CDB length 
14 DWORD pointer to target CCB list 
18 WORD number of target CCBs 
--other functions 
0 DWORD pointer to peripheral driver 
4h DWORD pointer to next CCB 
8h DWORD OS-dependent request mapping information 
[Ch DWORD _ address of completion callback routine 
20 DWORD pointer to scatter/gather list or data buffer 
24 DWORD length of data transfer 
28h DWORD pointer to sense info buffer 
2Ch BYTE length of sense info buffer 
2Dh BYTE CDB length 
22 WORD number of scatter/gather entries 
30h 4BYTEs reserved 
34h BYTE SCSI status 
35h 3BYTEs reserved 
38) DWORD residual length 
40h 12 BYTEs Command Descriptor Block (CDB) 
44h DWORD O$-dependent timeout value 
48h DWORD _ pointer to message buffer 
4Ch WORD length of message buffer 
4Eh WORD _vendor-unique flags 
50h BYTE tag queue action 
Sih 3BYTEs reserved 
54h NBYTEs _ private data area for SIM 
Table 6-7. Values for CAM function code: 
Value Meaning Value Meaning 
00h NOP 12h reset SCSI device 
Oth execute SCSI I/O 13h terminate I/O process 
02h get device type 14h-IFh reserved 
03h path inquiry 20h engine inquiry 
04h release SIM queue 2th execute engine request 
05h set asyne callback 22h-2Fh reserved 
06h set device type 30h enable logical unit number 
O7h-OFh reserved 3th execute target I/O 
10h abort SCSI command 32h-7Fh reserved 


lih reset SCSI bus 80h-FFh vendor-specific functions 


6-22 Low-Level Disk /O 


Table 6-8. Values for CAM status: 





Value Meaning Value Meaning 

00h request in progress tlh no HBA detected 

Oth request successful 12h data over/underrun 

02h host aborted request 13h bus freed unexpectedly 

03) unable to abort request 14h target bus phase sequence failure 
041 request completed with error 15h CCB too small 

05h CAM is busy 16h requested capability not available 
06h invalid request 17h sent bus device reset 

07h invalid path ID 18h terminate I/O process 

08) no such SCSI device 38h invalid LUN 

09h unable to terminate I/O process 39h invalid target ID 

OAh timeout on target selection 3Ah unimplemented function 

OBh timeout on command 3Bh nexus not established 

ODh receive message rejection 3Ch invalid initiator ID 

QEh sent/received SCSI bus reset 3Dh received SCSI Command Descriptor Block 
OF detected uncorrectable parity error 3Eh LUN already enabled 

10h Autosense request failed 3Fh SCSI bus busy 


Note: bit 6 of the status is set to indicate a frozen SIM queue; bit 7 is set to indicate valid autosense 


Completion callback function called with: 
interrupts disabled 
ES:BX -> completed CCB 


Asynchronous callback function called with: 
AH = opcode 
AL = path ID generating callback 
DH = target ID causing event 
DL =LUN causing event 
CX = data byte count (if applicable) 
ES:BX -> data buffer (if applicable) 


Return with: all registers preserved 
INTERRUPT 4Fh - Function 8200h 
Common Access Method rev 2.3 - INSTALLATION CHECK 


Purpose: Determine whether a driver conforming to the CAM SCSI interface specification (revision 2.3 or higher) is 
installed. 


Available on: Machines equipped with a SCSI host Restrictions: none. 
adaptor 

Registers at call: Return Registers: 

AX = 8200h AH = 00h if installed 

CX = 8765h CX = 9ABCh 

DX = CBA9h DX = 5678h 


ES:DI -> "SCSI_CAM" 
Conflicts: Z100 Slave 8259 (chapter 2) 
See Also: Function 8100h, INT 4Bh 


INTERRUPTS 60h to 63h 
Adaptec and OMT! controllers - DRIVE 0 DATA 


Purpose: These interrupts do not contain any addresses; rather, they store the actual hard disk parameter table 
pointed at by INT 41h. 
Available on: Machines with Adaptec and OMTI Restrictions: none. 

hard-disk controllers. 
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Details: Adaptec controllers which use these interrupts for data storage provide a small device driver which relocates 
the data into the device driver, protecting it from corruption and allowing the use of these interrupts for actual 
vectors. 

Conflicts: 4+Power Floppy Controller Original INT 13h/INT 40h, Oracle SQL Protected Mode Executive (chapter 
9). Also see Table 1-3 in Chapter 1. 

See Also: Adaptec INT 64h 


INTERRUPTS 64h to 67h 
Adaptec controllers - DRIVE 1 DATA 
Purpose: These interrupts do not contain any addresses; rather, they store the actual hard disk parameter table 
pointed at by INT 46h. 
Available on: Machines with Adaptec hard-disk Restrictions: none. 
controllers. 
Details: Adaptec controllers which use these interrupts for data storage provide a small device driver which relocates 
the data into the device driver, protecting it from corruption and allowing the use of these interrupts for actual 
vectors. 
Conflicts: EMS (chapter [0). Also see Table 1-3 in Chapter 1, 
See Also: Adaptec/OMTI INT 60h 


INTERRUPT 78h - Function 00h 


TARGA.DEV - SET /0 PORT 

Purpose: Specify at which location in the I/O address space the SCSI controller may be accessed. 
Available on: All machines. Restrictions: TARGA.DEV must be installed. 
Registers at call: Return Registers: 

AH = 00h CF set on error 

DX = interface board 1/O port AL = error code 


00h illegal command given to SCSI code 
O1h invalid I/O port specified (must be from 
100H to 3F8H, and must be on an 
8-port boundary) 
02h invalid DMA channel specified (must be 
from | to 3) 
03h invalid SCSI board number specified 
(must be from 0 to 7) 
04h error from data register during self-test 
05h SCSI input signals not all 0 when SCSI 
RST activated 
06h SCSI input signals not all 0 before 
selecting a SCSI device 
07h BSY signal is active; SCSI bus is busy 
08h SCSI board not selected, BSY signal did 
not come on in response to raising SEL 
09h time-out waiting for status state, 
signifying end of DMA transfer 
Details; TARGA.DEV is a CMC International SCSI device driver. If this routine is not called, the port is the driver's 
default (usually 0280h or 0300h). An installation check is performed by TARGA.DEV upon initialization by 
checking for the string "SCSI" at offset 03h into the interrupt handler, 
Conflicts: DBOS (chapter 9). 
See Also: Functions 01h and 02h 


INTERRUPT 78h - Function 01h 
TARGA.DEV - GET /0 PORT 


Purpose: Determine at which location in the I/O address space the SCSI controller may be accessed, 


| 
| 
| 
| 
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Available on: All machines. Restrictions: TARGA.DEV must be installed. 
Registers at call: Return Registers: 
AH=0Oth DX = current interface board J/O port 


Details: TARGA.DEV is a CMC International SCSI device driver. 
Conflicts: DBOS (chapter 9). 
See Also: Functions 00h and 03h 


INTERRUPT 78h - Function 02h 
TARGA.DEV - SET DMA CHANNEL 


Purpose: Specify which DMA channel the SCSI controller should use for data transfers. 


Available on: Ali machines. Restrictions: TARGA.DEV must be installed. 
Registers at call: Return Registers: 

AH = 02h CF set on error 

AL = interface board DMA channel AL = error code (see Function 00h) 


Details: TARGA.DEV is a CMC International SCSI device driver. If this routine is not called, the DMA channel 
used will be the driver's default (usually 3). 

Conflicts: DBOS (chapter 9). 

See Also: Functions 00h and 03h 


INTERRUPT 78h - Function 03h 
TARGA.DEV - GET DMA CHANNEL 


Purpose: Determine which DMA channel the SCSI controller is using for data transfers. 


Available on: All machines. Restrictions: TARGA.DEV must be installed. 
Registers at call: Return Registers: 
AH = 03h AL = current interface board DMA channel 


Details: TARGA.DEV is a CMC International SCSI device driver. 
Conflicts: DBOS (chapter 9). 
See Also: Functions 01h and 02h 


INTERRUPT 78h - Function 04h 
TARGA.DEV - SET SCSI DEVICE NUMBER 


Purpose: Specify the logical device number for the SCSI controller. 


Available on: All machines. Restrictions: TARGA.DEV must be installed. 
Registers at call: Return Registers: 

AH = 04h CF set on error 

AL = SCSI device number AL = error code (see AH=00h) 


Details: If this routine is not called, the device number used will be the driver's default (usually 0) 
Conflicts: DBOS (chapter 9). 
See Also: Functions 02h and 05h 


INTERRUPT 78h - Function 05h 
TARGA.DEV - GET SCS! DEVICE NUMBER 


Purpose: Determine the current logical device number of the SCSI controller. 


Available on: All machines. Restrictions: TARGA.DEV must be installed, 
Registers at call: Return Registers: 
AH = 05h AL = current SCSI device number 


Details: TARGA.DEV is a CMC International SCSI device driver. 
Conflicts: DBOS (chapter 9). 
See Also: Functions 03h and 04h 


INTERRUPT 78h - Function 06h 
TARGA.DEV - SET/CLEAR EARLY RETURN MODE 


Purpose: Specify whether a SCSI command function call may return before the command completes. 
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Available on: All machines. Restrictions: TARGA.DEV must be installed. 
Registers at call: Return Registers: n/a 
AH = 06h 


AL = 00h clear early return mode 
= Oth set early return mode 
Details: If early return mode is set then SCSI will return with no errors when the last DMA transfer is started in a 
call to Functions 13h or 14h. Barly return mode is cleared until this function is called. 
Conflicts: DBOS (chapter 9). 
See Also: Functions 13h, 14h, and 15h 


INTERRUPT 78h - Function 08h 
TARGA.DEV - INTERFACE BOARD SELF-TEST 


Purpose: Perform diagnostics on the SCSI controller. 


Available on: All machines. Restrictions: TARGA.DEV must be installed. 
Registers at call: Return Registers: 
AH = 08h CF set on error 


AL = error code (see Function 00h) 
Details: This function also resets the SCSI bus. 
Conflicts: DBOS (chapter 9), 
See Also: Function 09h 


INTERRUPT 78h - Function 09h 
TARGA.DEV - RESET SCSI BUS 


Purpose: Reset the SCSI bus. 


Available on: All machines. Restrictions: TARGA.DEV must be installed. 
Registers at call: Return Registers: 
AH = 09h CF set on error 


AL = error code (see Function 00h) 
Details: TARGA.DEV is a CMC International SCSI device driver, 
Conflicts: DBOS (chapter 9). 
See Also: Function 08h 


INTERRUPT 78h - Function 10h 
TARGA.DEV - SEND SCSI COMMAND 


Purpose: Transmit a requets to the SCSI controller which does not involve a data transfer. 


Available on: Ail machines. Restrictions: TARGA.DEV must be installed. 
Registers at call: Return Registers: 

AH = 10h AH = SCSI status byte 

DS:SI -> command bytes (Table 6-9) CF clear if successful 


AL = SCSI message byte 
CF set on error 
AL = error code (see Function 00h) 
Details: TARGA.DEV is a CMC International SCSI device driver. 
Conflicts: DBOS (chapter 9). 
See Also: Function 11h 


Table 6-9. Format of SCSI Command: 
Offset Size Description 


00h BYTE length of command 
O1h variable command bytes 
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INTERRUPT 78h - Function 11h 
TARGA.DEV - SEND SCS} COMMAND, RECEIVE DATA (PROGRAMMED /O) 


Purpose: Transmit a request to read data from a device on the SCSI bus. 


Available on: Ali machines. Restrictions: TARGA.DEV must be installed. 
Registers at call: Return Registers: 

AH= Ith AH = SCSI status byte 

DS:SI -> command bytes (Table 6-9) CF clear if successful 

ES:BX -> data storage area AL = SCSI message byte 

CX = number of data bytes to transfer CF set on error 


AL = error code (see AH=00h) 
Details: This command receives data internally one byte at a time, using the CPU to receive each byte. 
Conflicts: DBOS (chapter 9). 
See Also: Functions 10h and 13h 


INTERRUPT 78h - Function 12h 
TARGA.DEV - SEND SCS! COMMAND AND DATA (PROGRAMMED 1/0) 


Purpose: Transmit a request to write data to a device on the SCSI bus. 


Available on: All machines. Restrictions: TARGA.DEV must be installed. 
Registers at call: Return Registers: 

AH = 12h AH = SCSI status byte 

DS:SI -> command bytes (Table 6-9) CF clear if successful 

ES:BX -> data storage area AL = SCSI message byte 

CX = number of data bytes to transfer CF set on error 


AL = error code (see AH=00h) 
Details: This command sends data internally one byte at a time, using the CPU to send each byte. 
Conflicts: DBOS (chapter 9). 
See Also: Function 14h 


INTERRUPT 78h - Function 13h 
TARGA.DEV - SEND SCSI COMMAND, RECEIVE DATA (DMA) 


Purpose: Transmit a request to read data from a device on the SCSI bus. 


Available on: All machines. Restrictions; TARGA.DEV must be installed. 
Registers at call: Return Registers: 

AH= 13h AH = SCSI status byte (if early return mode is clear) 
DS:SI -> command bytes (Table 6-9) CF clear if successful 

ES:BX -> data storage area AL = SCSI message byte (if early return mode is 
DX:CX = number of data bytes to transfer clear) 


CF set on error 
AL = error code (see AH=00h) 
Details: This command receives data using DMA transfers. 
Conflicts: DBOS (chapter 9). 
See Also: Functions 11h and 12h 


INTERRUPT 78h - Function 14h 
TARGA.DEV - SEND SCS! COMMAND AND DATA (DMA) 


Purpose: Transmit a request to write data to a device on the SCSI bus. 
Available on: All machines. Restrictions: TARGA.DEV must be installed. 
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Registers at call: 

AH = 14h 

DS:SI -> command bytes (Table 6-9) 
ES:BX -> data storage area 

DX:CX = number of data bytes to transfer 


Details; This command sends data using DMA transfers. 


Conflicts: DBOS (chapter 9). 
See Also: Functions 12h and 13h 


INTERRUPT 78h - Function 15h 
TARGA,DEV - FINISH DATA TRANSFER (DMA) 


Purpose: Wait until the last SCSI command completes. 
Available on: All machines. 

Registers at call: 

AH = 15h 
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Return Registers: 
AH = SCSI status byte (if early return mode is clear) 
CF clear if successful 
AL = SCSI message byte (if early return mode is 
clear) 
CF set on error 
AL =error code (see Function 00h) 


Restrictions: TARGA.DEV must be installed. 
Return Registers: 
AH = SCSI status byte 
CF clear if successful 
AL = SCSI message byte 
CF set on error 
AL = error code (see Function 00h) 


Details: If Function 06h was previously called to set the early return mode, this function terminates a command 
started by Function 13h or 14h which returned before the last DMA transfer was completed. 


Conflicts: DBOS (chapter 9). 
See Also: Functions 06h, 13h, and 14h 


Disk Caches 


The functions described in this section are used by disk cache programs. 


INTERRUPT 13h - Function 1Dh 
IBMCACHE.SYS - CACHE STATUS 


Purpose: Determine or update cache status, 
Available on: All machines. 
Registers at call: 
AH = 1Dh 
AL = subfunction: 
Oth get status record: 
DL = drive 


02h set cache status: 
ES:BX -> status record (Table 6-10) 
DL = drive 
Conflicts: None known, 


Table 6-10. Format of status record: 


Restrictions: IBMCACHE.SYS must be installed. 
Return Registers: 


ES:BX -> status record (Table 6-10) 
CF set on error 

AH = error code 

CF set on error 


Offset Size Description 

00h DWORD total number of read requests 

04h DWORD _ total number of hits 

08h DWORD _ number of physical disk reads 

0Ch DWORD total number of sectors requested by physical disk reads 
10h 6BYTEs unknown. 

16h DWORD pointer to start of error list (Table 6-11) 


[Ah DWORD pointer to end of error list 
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Table 6-10. Format of status record (continued) 


Offset Size Description 

1Eh WORD unknown. 

20h BYTE using extended memory if nonzero 
2th BYTE unknown, 

22h 4BYTEs ASCII version number 

26h WORD cache size in K 

28h WORD sectors per page 


Table 6-11, Format of error list entry: 


Offset Size Description 

00h DWORD relative block address of bad page 
04h BYTE drive 

05h BYTE sector bit-map 

06h WORD next error 


INTERRUPT 13h « Function 20h, Subfunction FFh 
QCACHE - DISMOUNT 


Purpose: Apparently used to remove QCACHE from system. 


Available on: All machines. Restrictions; QCACHE must be installed. 
Registers at call: Return Registers: unknown. 
AX = 20FFh 


Conflicts: Western Digital “Super BIOS” 


INTERRUPT 13h - Function 21h 
QCACHE - FLUSH CACHE 


Purpose: Write cache content to disk and invalidate cache buffers. 


Available on: All machines. Restrictions; QCACHE must be installed. 
Registers at call: Return Registers: unknown. 
AH = 21h 


Conflicts: None known, 
See Also: QCACHE Functions 25h and 2Eh 


INTERRUPT 13h - Function 22h 
QCACHE - ENABLE/DISABLE CACHE 


Purpose: Control QCACHE operation. 


Available on: All machines. Restrictions: QCACHE must be installed. 
Registers at call: Return Registers: unknown. 
AH = 22h 


AL = 00h disable cache 
Olh enable cache 
Conflicts: None known. 


INTERRUPT 13h - Function 24h 
QCACHE - SET SECTORS 


Purpose: unknown. 


Available on: All machines, Restrictions: QCACHE must be installed. 
Registers at call: Return Registers: unknown. 
AH = 24h 


BX = number of sectors 
Conflicts: None known, 


INTERRUPT 13h - Function 25h 
QCACHE - SET FLUSH INTERVAL 


Purpose: Establish interval for automatic cache flushing. 
Available on: Ali machines. 

Registers at call: 

AH = 25h 

BX = interval 

Conflicts: None known. 

See Also: QCACHE Functions 21h and 2Eh 


INTERRUPT 13h - Function 27h 
QCACHE - INSTALLATION CHECK 


Purpose: Determine whether QCACHE is present. 
Available on: All machines. 

Registers at call: 

AH = 27h 

BX = 0000h 

Conflicts: None known. 


INTERRUPT 13h - Function 2Ah 
QCACHE - SET BUFFER SIZE 


Purpose: Establish size of buffer for cache. 
Available on: All machines. 

Registers at call: 

AH = 2Ah 

AL = buffer size 

Conflicts: None known. 


INTERRUPT 13h - Function 2Ch 
QCACHE - SET BUFFERED WRITES 


Purpose: Control whether cache will buffer disk writes. 
Available on: All machines, 
Registers at call: 
AH=2Ch 
AL= 00h disable buffered writes 
Oth enable buffered writes 
Conflicts: None known. 
See Also: QCACHE Function 2Dh 


INTERRUPT 13h - Function 2Dh 
QCACHE - SET BUFFERED READ 


Purpose: Control whether cache will buffer disk reads. 

Available on: All machines. 

Registers at call: 

AH = 2Dh 

AL= 00h disable buffered reads 
Olh enable buffered reads 

Conflicts: None known. 

See Also: QCACHE Function 2Ch 
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Restrictions: QCACHE must be installed. 
Return Registers: unknown. 


Restrictions: none. 
Return Registers: 
BX nonzero if installed. 


Restrictions: QCACHE must be installed. 
Return Registers: unknown. 


Restrictions: QCACHE must be installed. 
Return Registers: unknown. 


Restrictions: QCACHE must be installed, 
Return Registers: unknown. 
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INTERRUPT 13h - Function 2Eh 


QCACHE - SET FLUSH COUNT 

Purpose: unknown. 

Available on: All machines. Restrictions: QCACHE must be installed. 
Registers at call: Return Registers: unknown. 

AH = 2Eh 


BX = flush count 
Conflicts: None known. 
See Also: QCACHE Functions 21h and 25h 


INTERRUPT 13h - Function 30h 


QCACHE - GET INFO 

Purpose: Determine cache operating conditions. 

Available on: All machines. Restrictions: QCACHE must be installed. 
Registers at call: Return Registers: raknown. 

AH = 30h 


AL = what to get: 

00h system info 

Olh drive info 
DS:DX -> buffer for info 
Conflicts: None known. 


INTERRUPT 13h - Function 75h 


Unknown Function 

Purpose: wiknown. 

Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: unknown 
AH= 75h 


addtional registers, if any, unknown 
Details: This function is intercepted by PC-Cache (v5.1 only), but no further information is known about it. 


INTERRUPT 13h - Function 76h 


Unknown Function 

Purpose: unknown. 

Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: unknown 
AH = 76h 


addtional registers, if any, unknown 
Details: This function is intercepted by PC-Cache (v5.1 only), but no further information is known about it. 


INTERRUPT 13h - Function 81h 
Super PC Kwik/PC-Cache 5.x - Unknown Function 


Purpose: wiknown. 


Available on: All machines, Restrictions: Super PC Kwik or PC-Cache v5.x must 
be loaded. 

Registers at call: Return Registers: unknown. 

AH= 81h 

SI = 4358h 


Other registers, if any, unknown. 

Details: PC Tools PC-Cache v5.x is an OEM version of Super PC Kwik, and thus supports this call. However, PC- 
Cache does nothing and returns immediately. 

Conflicts: None known, 
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INTERRUPT 13h - Function 82h 
Super PC Kwik/PC-Cache 5.x - Unknown Function 


Purpose: unknown, 


Available on: All machines. Restrictions: Super PC Kwik or PC-Cache v5.x must 
be loaded. 

Registers at call: Return Registers: 

AH = 82h AL = unknown 

SI = 4358h additional return values, if any, unknown, 


Other registers, if any, unknown, 

Details: PC Tools PC-Cache v5.x is an OEM version of Super PC Kwik, and thus supports this call. 
Conflicts: None known, 

See Also: Function 84h 


INTERRUPT 13h - Function 83h 
Super PC Kwik/PC-Cache 5.x - Unknown Function 


Purpose: unknown. 


Available on: All machines, Restrictions: Super PC Kwik or PC-Cache v5.x must 
be loaded. 

Registers at call: Return Registers: unknown. 

AH = 83h 

SI = 4358h 


AL = unknown 

ES:BX -> unknown 

other registers, if any, unknown. 

Details: PC Tools PC-Cache v5.x is an OEM version of Super PC Kwik, and thus supports this call. 
Conflicts: None known. 

See Also: Function 85h 


INTERRUPT 13h - Function 84h 
Super PC Kwik/PC-Cache 5.x - Unknown Function 


Purpose: unknown. 


Available on: All machines. Restrictions: Super PC Kwik or PC-Cache v5.x must 
be loaded. 

Registers at call: Return Registers: 

AH = 84h AL = unknown 

SI = 4358h additional return values, if any, unknown. 


AL = unknown 

other registers, if any, unknown. 

Details: PC Tools PC-Cache v5.x is an OEM version of Super PC Kwik, and thus supports this call. 
Conflicts: None known. 

See Also: Function 82h 


INTERRUPT 13h - Function 85h 
Super PC Kwik/PC-Cache 5.x - Unknown Function 


Purpose: unknown. 
Available on: All machines. Restrictions: Super PC Kwik or PC-Cache v5.x must 
be loaded. 
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Registers at call: Return Registers: unknown. 

AH = 85h 

SI = 4358h 

AL = unknown 

DL = unknown 

other registers, if any, unknown. 

Details: PC Tools PC-Cache v5.x is an OEM version of Super PC Kwik, and thus supports this call. 
Conflicts: None known. 

See Also: Function 83h 


INTERRUPT 13h - Function 8Eh, Subfunction EDh 
HyperDisk - Unknown Function 


Purpose: unknown, 


Available on: All machines. Restrictions: HyperDisk cache version 4.01 or higher 
must be installed, 

Registers at call: Return Registers: unknown. 

AX = 8EEDh 


other registers, if any, unknown. 

Details: HyperDisk is a shareware disk cache by Roger Cross. 
Conflicts: None known. 

See Also: Function 8Eh Subfunctions EBh and EFh, Function EEh 


INTERRUPT 13h - Function 8Eh, Subfunction EEh 
HyperDisk - Unknown Function 


Purpose: unknown. 


Available on: All machines. Restrictions: HyperDisk cache version 4.01 or higher 
must be installed. 

Registers at call: Return Registers: 

AX = 8EEEh CF set 


AX = CS of HyperDisk resident code 
other return values, if any, unknown. 
Conflicts: None known. 
See Also: Function 8Eh Subfunctions EDh and EFh, Function EEh 


INTERRUPT 13h - Function 8Eh, Subfunction EFh 
HyperDisk - Unknown Function 


Purpose: unknown. 


Available on: All machines. Restrictions: HyperDisk cache version 4.01 or higher 
must be installed. 

Registers at call: Return Registers: 

AX = 8EEFh unknown. CF set 


AX = CS of HyperDisk resident code 
other return values, if any, unknown. 
Conflicts: None known. 
See Also: Function 8Eh Subfunction EDh and EEh, Function EEh 


INTERRUPT 13h - Function AOh 
Super PC Kwik - GET RESIDENT CODE SEGMENT 


Purpose: Determine address at which cache TSR was loaded in order to access internal data. 
Available on: All machines. Restrictions: Super PC Kwik or PC-Cache v5.x must 
be loaded. 
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Registers at call: Return Registers: 
AH =AOh AX = segment of resident code 
SI = 4358h 


Details: PC Tools PC-Cache v5.x is an OEM version of Super PC Kwik, and thus supports this call. 
Conflicts: None known. 
See Also: INT 16h Function FFA5h Subfunction 111 1h 


INTERRUPT 13h - Function Ath 
Super PC Kwik - FLUSH CACHE 


Purpose: Write any modified cache buffers to disk immediately, and invalidate all cache buffers. 


Available on; All machines. Restrictions: Super PC Kwik or PC-Cache v5.x must 
be loaded. 

Registers at call: Return Registers: unknown. 

AH = Alh 

SI = 4358h 


Details: PC Tools PC-Cache v5.x is an OEM version of Super PC Kwik, and thus supports this call. 
Conflicts: None known. 
See Also: INT 16h Function FFA5h Subfunction FFFFh 


INTERRUPT 13h - Function A2h 
Super PC Kwik - Unknown Function 


Purpose: unknown. 


Available on: All machines. Restrictions: Super PC Kwik or PC-Cache v5.x must 
be loaded, 

Registers at call: Return Registers: unknown. 

AH = A2h 

SI = 4358h 


other registers, if any, unknown. 
Details: PC Tools PC-Cache v5.x is an OEM version of Super PC Kwik, and thus supports this call. 
Conflicts: None known. 


INTERRUPT 13h - Function BOh 
Super PC Kwik - Unknown Function 


Purpose: unknown, 


Available on: All machines. Restrictions: Super PC Kwik or PC-Cache v5.x must 
be loaded. 

Registers at call: Return Registers: unknown. 

AH = BOh 

SI = 4358h 


other registers, if any, unknown, 
Details: PC Tools PC-Cache v5.x is an OEM version of Super PC Kwik, and thus supports this call. 
Conflicts: None known. 


INTERRUPT 13h - Function EEh 
HyperDisk, PC-Cache - SWBIOS COMPATIBILITY 


Purpose: Permit access to cylinders beyond the first 1024 supported directly by the ROM BIOS. 


Available on: All machines. Restrictions: HyperDisk (version 4.01 or higher) or 
PC-Cache (version 5.5 or higher) must 
be installed. 

Registers at call: Return Registers: 

AH = EEh CF clear 


DL = drive number (80h, 81h) AH = 00h 
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Details: Recent versions of HyperDisk and PC-Cache support this call in order to properly cache large disks which 
use SWBIOS to access more than 1024 cylinders. 

Conflicts: None known. 

See Also: Function 8Eh Subfunction EDh, EEh, and EFh, SWBIOS Function EEh 


INTERRUPT 16h - Function FFASh, Subfunction 1111h 
PC-Cache « INSTALLATION CHECK 


Purpose: Determine whether PC-Cache is loaded. 


Available on: All machines. Restrictions: Only valid for PC-Cache version 6.0 or 
higher, 
Registers at call: Return Registers: 
AX = FFASh CH = 00h if installed 
CX=111ilh ES:DI -> internal data (Table 6-12) 
: CL = cache state 
Olh enabled 
02h disabled 


Conflicts: None known. 
See Also: INT [3h Function AOh, INT 2th Function 2Bh 


Table 6-12. Format of PC-Cache internal data: 


Offset Size Description 
«“1Ch 20 BYTEs cached drive list, one byte per drive A: to T: 
each byte is either blank (20h) or drive letter(41h-54h) 
“8 BYTE unknown, 
-7 WORD number of physical transfers (scaled down to 0000h-7FFFh) 
5 WORD number of saved transfers (scaled down to 0000h-7FFFh) 
3 3BYTEs unknown. 


INTERRUPT 16h - Function FFA5h, Subfunction AAAAh 
PC-Cache - ENABLE DELAYED WRITES 


Purpose: Allow cache to return to caller before disk writes complete. 


Available on: All machines. Restrictions: PC-Cache version 6.0 or higher must be 
installed. 

Registers at call: Return Registers: 

AX = FFASh AX = apparently either 0000h or sectors_in_cache - 5 

CX = AAAAh 


Conflicts: None known. 
See Also: Function FFASh Subfunction CCCCh 


INTERRUPT 16h - Function FFASh, Subfunction CCCCh 
PC-Cache - FLUSH CACHE AND DISABLE DELAYED WRITES 


Purpose: Write all modified cache buffers to disk and then set cache into write-through mode. 


Available on: All machines. Restrictions: PC-Cache version 6.0 or higher must be 
installed, 

Registers at call: Return Registers: 

AX = FFASh AX = apparently either 0000h or sectors_in_cache - 5 

CX =CCCCh 


Details: Delayed writes are automatically disabled on executing a program named either WIN.CO? or DV.E??; 
however, delayed writes are not automatically reenabled upon the program's termination in version 6. 

Conflicts: None known. 

See Also: Function FFASh Subfunctions AAAAh and FFFFh 
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INTERRUPT 16h - Function FFA5h, Subfunction DDDDh 
PC-Cache - FLUSH AND DISABLE CACHE 


Purpose: Write all modified cache buffers to disk and then turn off the caching function. 


Available on: All machines. Restrictions: PC-Cache version 6.0 or higher must be 
installed. 

Registers at call: Return Registers: n/a 

AX = FFASh 

CX = DDDDh 


Details: After executing this function, all I/O requests will be passed directly to the disks, 
Conflicts: None known. 
See Also: Function FFA5h Subfunction EEEEh and FFFFh 


INTERRUPT 16h - Function FFA5h, Subfunction EEEEh 
PC-Cache - ENABLE CACHE 


Purpose: Turn on the caching function. 


Available on: All machines. Restrictions: PC-Cache version 6.0 or higher must be 
installed, 

Registers at call: Return Registers: n/a 

AX = FFASh 

CX = EEEEh 


Conflicts: None known. 
See Also: Function FFASh Subfunction DDDDh 


INTERRUPT 16h - Function FFASh, Subfunction FFFFh 
PC-Cache - FLUSH CACHE 


Purpose: Force all modified buffers in cache to be written to disk immediately, 


Available on: All machines. Restrictions: PC-Cache version 6.0 or higher must be 
installed. 

Registers at call: Return Registers: n/a 

AX = FFASh 

CX = FFFFh 


Conflicts: None known. 
See Also: Function FFASh Subfunctions CCCCh and DDDDh 


INTERRUPT 21h - Function 2Bh 
PC Tools v5.x PC-Cache - INSTALLATION CHECK 


Purpose: Determine whether PC Tools PC-Cache is present in system, 


Available on: All machines. Restrictions: Valid only for PC-Cache versions 5.x. 
Registers at call: Return Registers: 

AH =2Bh AL = FFh if PC-Cache not installed 

CX = 4358h (‘CX’) AL = 00h if installed 


CX = 6378h (‘cx’) 

BX = unknown, 

DX = unknown. 
Conflicts: DOS 1+ - Set System Date (chapter 8), DESQview - Installation Check (chapter 15), ELRES v1.1 
(chapter 36). 
See Also: INT 16h Function FFASh Subfunction 111 1h 


INTERRUPT 25h - Function FFh 
PC-CACHE.SYS - INSTALLATION CHECK 


Purpose: Determine whether the PC-CACHE.SYS driver is loaded in support of PC-Cache V5.X. 
Available on: All machines. Restrictions: none. 


| 
| 
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Registers at call: 
AL=FFh 
SI = 4358h 


Return Registers: 
SI = 6378h if installed 
CX = segment of device driver 
DX = driver version (major in DH, minor in DL) 


Details: PC-CACHE.SYS is a small device driver used by PC-Cache v5.x to obtain access to certain drivers for 


devices such as Bernoulli drives. 
Conflicts: DOS Absolute Disk Read (chapter 8). 


INTERRUPT 2Fh - Function DFh 
Multiplex - HyperDisk v4.20+ - INSTALLATION CHECK 


Purpose: Determine whether HyperDisk cache is installed. HyperDisk is a shareware disk cache by HyperWare 


(Roger Cross). 
Available on: All machines, 


Registers at call: 
AH = DFh 
BX = 4448h (‘DH’) 


Conflicts: See table 1-3 in chapter 1. 
See Also: INT 13h Function 8Eh Subfunction EDh 


INTERRUPT 21h - Function 44h, Subfunction 02h 
SMARTDRV.SYS - GET CACHE STATUS 


Purpose: Determine cache settings and caching statistics. 
Available on: All machines. 

Registers at call: 

AX = 4402h 

BX = file handle for device "SMARTAAR" 

CX = number of bytes to read (min 28h) 

DS:DX -> buffer for status record (Table 6-13) 


Conflicts: DOS IOCTL (chapter 8) 
See Also: Function 44h Subfunction 03h 


Table 6-13. Format of SMARTDRY status record: 


Restrictions: DOS versions prior to 3.0 must verify 
that the interrupt vector is not 
0000h:0000h before using INT 2Fh, 

Return Registers: 

AL = 00h not installed 

FFh installed 
CX = 5948h (‘YH') 
BX:DX -> ??? in resident portion if BX=4448h 
on entry 


Restrictions: SMARTDRV.SYS must be installed. 
Return Registers: 
CF clear if successful 
AX = number of bytes actually read 
CF set on error 
AX = error code (01h, 05h, 06h, ODh) 
(see DOS Function 59h, chapter 8) 


Offset Size Description 

00h BYTE write-through flag (always 01h) 

Olh BYTE writes should be buffered (always 00h) 

02h BYTE cache enabled if 01h 

03h BYTE driver type 

04h WORD clock ticks between cache flushes (currently unused) 
06h BYTE cache locked if nonzero 

07h BYTE flush cache on reboot if nonzero 

08h BYTE cache full track writes if nonzero 

09h BYTE double buffering state (00h off, 01h on, 02h dynamic) 
OAh DWORD _ original INT 13 vector 

OEh BYTE minor version number 

OFh BYTE major version number 

10h WORD unused 

12h WORD sectors read : 

14h WORD sectors already in cache > may be scaled rather than 
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Table 6-13. Format of SMARTDRY status record: 

Offset Size Description 

16h WORD sectors already in track buffer / absolute counts 

18h BYTE cache hit rate in percent 

19h BYTE track buffer hit rate in percent 

1Ah WORD total tracks in cache 

1Ch WORD number of tracks in use 

1Eh WORD number of locked tracks 

20h WORD number of dirty tracks 

22h WORD current cache size in 16K pages 

24h WORD original cache size in 16K pages 

26h WORD minimum cache size in 16K pages 

28h DWORD pointer to byte flag to increment for locking cache contents 


INTERRRUPT 21h - Function 44h, Subfunction 03h 
SMARTDRV.SYS - CACHE CONTROL 


Purpose: Control operation of cache, 
Available on: All machines. 


Registers at call: Return Registers: 
AX = 4403h CF clear if successful 
BX = handle for device "SMARTAAR" AX = number of bytes actually written 


CX = number of bytes to write CF set on error 
DS:DX -> SMARTDRYV control block (Table 6-14) AX = error code (01h, 05h, 06h, ODh) 
(see DOS Function 59h, chapter 8) 


Conflicts; DOS IJOCTL (chapter 8) 
See Also: Function 44h Subfunction 02h 


Table 6-14. Format of SMARTDRY control block: 


Offset Size Description 

00h BYTE function code 
00h flush cache 
Olh flush and discard cache 
02h disable caching 
03h enable caching 
O5h set flushing tick count 
06h lock cache contents 
07h unlock cache contents 
O8h set flush-on-reboot flag 
OBh reduce cache size 
OCh increase cache size 
ODh set INT 13 chain address 


---function 08h 
Olh BYTE new flush-on-reboot flag (00h off, 01h on) 


~-functions OBh,OCh 
Olh WORD number of 16K pages by which to increase/reduce cache size 


-~function 0Dh 
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Restrictions: SMARTDRV.SYS must be installed. 


Olh DWORD _ new address to which to chain on INT 13 Note: the previous address is not preserved 


Disk Compression 


The functions listed in this section affect the operation of programs which increase disk capacity by compressing all 


data written to the disk or automatically decompressing files when they are accessed. 
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INTERRUPT 21h - Function 44h, Subfunction 04h 
Stacker - GET DEVICE DRIVER ADDRESS AND SET VOLUME NUMBER 


Purpose: Determine the address at which the Stacker device driver has been loaded, and set an internal variable 
indicating the current volume number. 

Available on: All machines. Restrictions: Stacker driver must be installed. 
Registers at call: Return Registers: n/a 

AX = 4404h 

BL = drive number (00h = default, 01h = A;, ete) 

CX = 0004h 

DS:DX -> DWORD buffer to receive device driver 

address 

Details: In addition to returning the address of the Stacker device driver, this call also sets the volume number at 
offset 3Eh in the device driver (see INT 25h Function CDh Subfunction CDh), 

See Also: INT 25h Function CDh Subfunction CDh 


INTERRUPT 21h - Function 44h, Subfunction 10h 


ENABLE NewSpace DRIVER 


Purpose: Permit NewSpace to compress all data written to the disk and expand any compressed data which is read 
from the disk. 


Available on: All machines. Restrictions: NewSpace driver must be installed, 
Registers at call: Return Registers: unknown. 

AX = 4410h 

BX = FFFFh 


Details: NewSpace is a TSR by Isogon Corporation which automatically compresses all files as they are written and 
decompresses them as they are read; compressed files are not accessible unless the driver is enabled, 

Conflicts: DOS Generic IOCTL Capabilities (chapter 8) 

See Also: Function 44h Subfunction 11h 


INTERRUPT 21h - Function 44h, Subfunction 11h 
DISABLE NewSpace DRIVER 


Purpose: Prohibit NewSpace from compressing data which is written to the disk. 


Available on: All machines, Restrictions: NewSpace driver must be installed. 
Registers at call: Return Registers: unknown. 

AX = 4411h 

BX = FFFFh 


Details: NewSpace is a TSR by Isogon Corporation which automatically compresses all files as they are written and 
decompresses them as they are read; compressed files are not accessible unless the driver is enabled 

Conflicts: DOS Generic IOCTL Capabilities (chapter 8) 

See Also: Function 44h Subfunction 10h 


INTERRUPT 21h - Function 44h, Subfunction 12h 
NewSpace INSTALLATION CHECK 


Purpose: Apparently used to determine whether NewSpace is installed; also returns the address of the resident 
driver. 


Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AX = 4412h AX = PSP segment of NewRes (resident 
BX = FFFFh driver for NewSpace) 
BX:DX -> unknown data or code 
CX = unknown 


See Also: Function 44h Subfunction 11h 
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INTERRUPT 21h - Function 44h, Subfunction 13h 
NewSpace » GET UNKNOWN INFORMATION 


Purpose: unknown. 


Available‘on: All machines. Restrictions: NewSpace driver must be installed. 
Registers at call: Return Registers: 

AX = 4413h AX = code segment of NewRes (resident driver for 
BX = FFFFh NewSpace) 


BX = offset of unknown data or code 
See Also: Function 44h Subfunction [2h 


INTERRUPT 21h - Function 44h, Subfunction 14h 
NewSpace DEBUGGING DUMP 


Purpose: Store the complete internal state of NewSpace in a disk file for debugging purposes. 


Available on: All machines. Restrictions: NewSpace driver must be installed. 
Registers at call: Return Registers: 

AX = 4414h debugging dump written to NEWSPACE.SMP on 
BX = FFFFh current drive 


See Also: Function 44h Subfunctions 13h and FFh 


INTERRUPT 21h - Function 44h, Subfunction FFh 
NewSpace - Unknown Function 


Purpose: unknown. 


Available on: All machines. Restrictions: NewSpace driver must be installed. 
Registers at call: Return Registers: unknown. 

AX = 44FFh 

BX = FFFFh 


DX = unknown. 
See Also: Function 44h Subfunction 14h 


INTERRUPT 21h - Function DCh 
PCMANAGE/DCOMPRES - TURN ON OR OFF 


Purpose: Enable/disable automatic decompression of previously-compressed files. 


Available on: All machines, Restrictions: PC Magazine DCOMPRES must be 
installed. 
Registers at call: Return Registers: unknown. 
AH = DCh 
DX = 0000h turn on 
0001h turn off 


Conflicts: Novell NetWare (chapter 20). 
See Also: Function FEh Subfunction DCh 


INTERRUPT 21h - Function FEh, Subfunction DCh 
PCMANAGE/DCOMPRES - INSTALLATION CHECK 


Purpose: Determine whether the DCOMPRES resident driver for PC Magazine's automatic file compression system 
is installed. 


Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AX = FEDCh AX = CDEFh if installed 


Conflicts: DoubleDOS (chapter 17), "Black Monday" virus (chapter 34). 
See Also: Function DCh 
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INTERRUPT 25h - Function CDh, Subfunction CDh 
Stacker - GET DEVICE DRIVER ADDRESS 


Purpose: Determine whether the Stacker device driver is loaded and the address at which it was loaded. 


Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AX=CDCDh AX = CDCDh if installed 
DS:BX -> buffer for address (Table 6-15) DS:BX buffer filled 
CX = 0001h 

DX = 0000h 


Conflicts: DOS Absolute Disk Read (chapter 8). 
See Also: INT 21h Function 44h, Subfunction 04h 


Table 6-15. Format of device driver address buffer: 





Offset Size Description 

00h WORD signature CDCDh 

02h WORD unknown (apparently always 0001h) 

04h DWORD pointer to start of Stacker device driver (Table 6-16) 


Table 6-16. Format of Stacker device driver: 





Offset Size Description 

00h WORD signature ASSAh 

02h WORD Stacker version * 64h 

04h WORD offset of volume-specific information offset table 
(list of WORDs, one per drive, containing offsets to various 
information) 

06h S56BYTEs n/a 

3Eh BYTE volume number, set after INT 21/AX=4404h 
(use to index into volume-specific info offset table) 

3Fh 19 BYTEs n/a 

52h 4BYTEs ASCII string "SWAP" 

56h 26BYTEs drive mapping table (one byte for each drive A: through Z:) 


Table 6-17. Format of Stacker boot record: 


Offset Size Description 

1FOh 8BYTEs Stacker signature (first byte is CDh) 
1F8h DWORD __ pointer to start of Stacker device driver 
1FCh WORD Stacker volume number 


IFEh WORD unknown 





Chapter 7 


Serial I/O 


This chapter lists the interrupts involved with serial input/output. Since the original PC BIOS provided inadequate 
support for data communications, many third-party routines have been developed to fill the resulting need. This has 
led to more redundancy and conflict in this area than in any other single group of interrupts. 

Within this chapter, interrupts are divided into two major groups: those furnished as original equipment within the 
BIOS that comes with a system, and those furnished as third-party add-on packages. The "standard" group is listed by 
interrupt service first and then by function and subfunction, all in numeric sequence, The add-on packages are listed 
in alphabetic sequence by name, with each package then listed by interrupt, function, and subfunction. 

In addition to the calls here, there are some network calls which are related to serial I/O; those are discussed as part 
of the network software in the appropriate chapters (18 through 27). 





Standard BIOS Interface 


This group of functions includes those supplied with all machines, and those that are furnished only with specific 
models. It excludes the services that are available only as third-party add-ons. 


INTERRUPT 14h - Function 00h 


INITIALIZE PORT 

Purpose: Establish operating parameters for the specified serial port. 

Available on: All machines. Restrictions: none. 

Registers at call: Return Registers: 

AH = OOhAH = line status (see Table 7-2) 

AL = port parameters (see Table 7-1) AL = modem status (see Table 7-2) 


DX = port number (00h-03h) 

Details: The default handler is at FO00h:E739h in IBM PC and 100% compatible BIOSes. Since the PCjr supports a 
maximum of 4800 bps, attempting to set 9600 bps will result in 4800 bps. 

Conflicts: FOSSIL Initialize, which effectively replaces this function. 

See Also: Function 04h, Function 05h, MultiDOS Function 04h (chapter 16), COURIERS.COM Function 82h, COU- 


RIERS.COM Function 8Ch 
INTERRUPT 14h - Function 01h 


WRITE GHARACTER TO PORT 

Purpose: Output one character to the specified serial port. 

Available on: All machines. Restrictions: none. 

Registers at call: Return Registers: 

AH = 01hAH bit 7 clear if successful AH bit 7 set on error 

AL = character to write AH bits 6-0 = port status (see Table 7-2) 


DX = port number (00h-03h) 
Conflicts: None known. 
See Also: Function 02h, FOSSIL Function 0Bh, COURIERS.COM Function 89h 
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Table 7-1. Serial Port Initialization Parameters 


PARITY STOP 
-BAUD RATE- BITS LENGTH WORD 
7-6-5 4-3 2 1-0 
000: 110* 00: none 0:1 00: 5 
001: 150** 01: odd 1:2 01:6 
010: 300 10: none*** 10:7 
O11: 600 11: even 11:8 
100: 1200 
101: 2400 
110: 4800 
111: 9600 (4800 on PCjr) 
Table 7-2, Serial Port Status Returns 
Reg Bit 7 Bit 6 Bit Bit 4 Bit 3 Bit 2 Bit 1 Bit 0 
AH Timeout Transmit Transmit Break Framing Parity Overrun Receive 
Shift Holding Detected Error Error Error Data 
Register Register Ready 
Empty Empty 
AL Carrier Ring Data Clear Delta Trailing Delta Delta 
Detect Indicator Set to Carrier Edgeof DataSet Clear 
(CD) (RI Ready Send Detect Ring Ready to Send 
(DSR) (CTS) 
INTERRUPT 14h - Function 02h 
READ CHARACTER FROM PORT 
Purpose: Read one character from the specified port, waiting if necessary. 
Available on: All machines, Restrictions: none. 
Registers at call: Return Registers: 
AH = 02h AH = line status (see Table 7-2) 
DX = port number (00h-03h) AL = received character if AH bit 7 clear 


Details: Will timeout if DSR is not asserted, even if function 03h returns data ready. 
Conflicts; FOSSIL - Receive Character With Wait. 
See Also: Function 01h, COURIERS.COM Function 84h, IBM/Yale EBIOS Function FCh, FOSSIL Function 02h 


INTERRUPT 14h - Function 03h 


GET PORT STATUS 

Purpose: Read the status of the specified serial port. 

Available on: All machines. Restrictions: none. 

Registers at call: Return Registers: 

AH = 03h AH = line status (see Table 7-2) 
DX = port number (00h-03h) AL = modem status (see Table 7-2) 


Conflicts: None known. 
See Also: Function 00h, MultiDOS Function 07h (chapter 16), COURIERS.COM Function 81h, IBM/Yale EBIOS 
Function FDh Subfunction 02h 





* Standard BIOS only, 19,200 BPS for FOSSIL initialization. 
** Standard BIOS only, 38,400 BPS for FOSSIL initialization. 
* Standard BIOS only, not defined for FOSSIL initialization. 
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INTERRUPT 14h - Function 04h 
EXTENDED INITIALIZE 
Purpose: Establish operating conditions for the specified serial port. 
Available on: IBM Convertible and PS/2 models Restrictions: none. 
only. 
Registers at call: Return Registers: 
AH = 04h AX = port status code (see Table 7-2) 
AL = break status: 
00h if break 
O1h if no break 
BH = parity: 
00h no parity 
Olh odd parity 
02h even parity 
O3h stick parity odd 
04h stick parity even 
BL = number of stop bits: 
00h one stop bit 
Oth two stop bits (1.5 if 5 bit word Jength) 
CH = word length: 
00h 5 bits 
Oth 6 bits 
02h 7 bits 
03h 8 bits 
CL = bps rate: 
00h 110 
Olh 150 
02h 300 
03h 600 
04h 1200 
05h 2400 
06h 4800 
07h 9600 
08h 19200 
DX = port number 
Conflicts: FOSSIL - Initialize Driver, MultiDOS Plus IODRV - Initialize Port (chapter 16). 


See Also: Function 00h, FOSSIL Function 1Eh 


INTERRUPT 14h - Function 05h 
EXTENDED COMMUNICATION PORT CONTROL 


Purpose: Determine or establish additional operating conditions for the specified serial port. 





Available on: IBM Convertible and PS/2 models Restrictions: none. 
only. 

Registers at call: Return Registers: 

AH = 05h vary with function: 


DX = port number 


AL = function: 
00h read modem control register BL = modem control register (see below) 
AH & status (see Table 7-2) 
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Oth write modem control register 
BL = modem control register: AX = status (see Table 7-2) 
bit 0: data terminal ready 
bit 1: request to send 
bit 2: OUT1 
bit 3: OUT2 
bit 4: LOOP 
bits 5-7 reserved 
Conflicts: FOSSIL - Deinitialize Driver, MultiDOS Plus IODRV - Read Character from Port (chapter 16). 
See Also: Function 00h, FOSSIL Function 1Fh 


Third-Party BIOS-like Systems 

This group of functions includes all serial I/O functions other than those included within the "standard" group. In 
several cases, specific subfunctions listed here essentially duplicate the matching subfunctions of the standard group, 
but are listed here with the rest of the package in which they are supplied. 


3com BAPI SERIAL I/O 
INTERRUPT 14h - Function AOh 


CONNECT TO PORT 

Purpose: Request a session on a serial port and establish a connection for that session. 

Available on: All machines. Restrictions: 3com BAPI must be installed. 
Registers at call: Return Registers: unknown. 

AH = AOh 


others unknown, 
Conflicts: Interconnections Inc. TES. 
See Also: 3com BAPI Function Alh 


INTERRUPT 14h - Function Aih 


DISCONNECT FROM PORT 

Purpose: Terminate a connection and free the serial port corresponding to that session, 

Available on: All machines. Restrictions; 3com BAPI must be installed. 
Registers at call: Return Registers: unknown. 

AH =Alh 


others unknown, 
Conflicts: Interconnections Inc. TES. 
See Also: 3com BAPI Function AOh 


INTERRUPT 14h - Function A4h 


WRITE BLOCK 

Purpose: Send one or more characters through the serial port corresponding to the specified connection. 
Available on: All machines. Restrictions: 3com BAPI must be installed. 
Registers at call: Return Registers: 

AH = A4h CX = number of bytes sent 

CX = length 


DH = session number (00h) 

ES:BX -> buffer 

Conflicts: Interconnections Inc. TES, 

See Also: FOSSIL Function 19h, COURIERS.COM Function 86h, 3com BAP] Function A5h 


INTERRUPT 14h - Function A5h 
READ BLOCK 


Purpose: Read characters from the serial port corresponding to the specified connection. 
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Available on: All machines. Restrictions: 3com BAP must be installed. 
Registers at call: Return Registers: 

AH = ASh CX = number of bytes read 

CX = length 


DH = session number (00h) 
ES:BX -> buffer 
Conflicts: Interconnections Inc, TES. 


See Also: FOSSIL Function 18h, COURIERS.COM Function 83h, 3com BAPI Function A4h, IBM/Yale EBIOS 


Function FFh Subfunction 02h 


INTERRUPT 14h - Function A6h 


SEND SHORT BREAK 

Purpose: Transmit a short (less than 0.5s) break character on the serial port for the specified session. 
Available on: All machines. Restrictions: 3com BAPI must be installed. 
Registers at call: Return Registers: n/a 

AH = A6h 


DH = session number (00h) 
Conflicts: Interconnections Inc, TES. 
See Also: FOSSIL Function | Ah, COURIERS.COM Function 8Ah, IBM/Yale EBIOS Function FAh 


INTERRUPT 14h - Function A7h 


READ STATUS 

Purpose: Determine status. 

Available on: All machines. Restrictions: 3com BAPI must be installed. 
Registers at call: Return Registers: unknown. 

AH = A7h 


others unknown. 
Conflicts: Interconnections Inc. TES. 


INTERRUPT 14h - Function AFh, Subfunction 00h 


INSTALLATION CHECK 

Purpose: Determine whether 3com BAPI Serial 1/O software is installed. 

Available on: All machines. Restrictions: None. 
Registers at call: Return Registers: 

AX = AFOOh AX = AFOLh if installed 
BX = AAAAh 


Conflicts: None known. 


INTERRUPT 14h - Function BOh 
ENABLE/DISABLE "ENTER COMMAND MODE" CHARACTER 


Purpose: Specify whether the control character that switches to command mode is honored. 


Available on: All machines. Restrictions: 3com BAPI must be installed. 
Registers at call: Return Registers: n/a 
AH = BOh 
AL= 00h disable 
Oth enable 


Conflicts: None known. 
INTERRUPT 14h - Function Bih 
ENTER COMMAND MODE 


Purpose: Switch to command mode, 
Available on: All machines. Restrictions: 3com BAPI must be installed. 
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Registers at call: Return Registers: n/a 
AH=Bih 
Conflicts: None known. 


AVATAR Serial Dispatcher 

The AVATAR Serial Dispatcher is a small module within AVATAR.SYS which allows multiple programs to share 
an interrupt request line, allowing the use of multiple serial ports on one IRQ. AVATAR.SYS (chapter 36) is a CON 
replacement by George Adam Stanislav which interprets AVATAR command codes in the same way that ANSLSYS 
interprets ANSI command codes. 


INTERRUPT 2Fh - Function 1Ah, Subfunction 42h 


INSTALL IRQ3 HANDLER 

Purpose: Add a routine to the chain of interrupt handlers for IRQ3. 

Available on: All machines. Restrictions: AVATAR driver must be installed. 
Registers at call: Return Registers: 

AX = 1A42h AX = 1A42h if ASD not installed 

BX = 4156h (AV') 0000h if no more room 

ES:DI -> FAR handler for serial port using IRQ3 else handle to use when uninstalling 


DS = data segment needed by handler 

Details: The handler need not save/restore registers or signal EOI to the interrupt controller. It should return 

AX=0000h if the interrupt was meant for it, and either leave AX unchanged or return a non-zero value otherwise. 
The most recently installed handler will be called first, continuing to earlier handlers until one returns 

AX=0000h. 

Conflicts: None known. 

See Also: Function 1Ah Subfunction 43h, Function 1Ah Subfunction 62h 


INTERRUPT 2Fh - Function 1Ah, Subfunction 43h 


INSTALL IRQ4 HANDLER 

Purpose: Add a routine to the chain of interrupt handlers for IRQ4, 

Available on: All machines. Restrictions: AVATAR driver must be installed. 

Registers at call: Return Registers: f 
AX = 1A43h AX = 1A43h if ASD not installed i 
BX = 4156h (‘AV’) 0000h if no more room 

ES:D] -> FAR handler for serial port using IRQ4 else handle to use when uninstalling 


DS = data segment needed by handler 

Details: The handler need not save/restore registers or signal EOI to the interrupt controller, It should return 

AX=0000h if the interrupt was meant for it, and either leave AX unchanged or return a non-zero value otherwise. 
The most recently installed handler will be called first, continuing to earlier handlers until one retums 

AX=0000h. 

Conflicts: None known. 

See Also: Function 1Ah Subfunction 42h, Function 1 Ah Subfunction 63h 


INTERRUPT 2Fh - Function 1Ah, Subfunction 62h 


UNINSTALL IRQ3 HANDLER 

Purpose: Remove a routine from the chain of interrupt handlers for TRQ3. 

Available on: All machines. Restrictions: AVATAR driver must be installed, 
Registers at call: Return Registers: n/a 

AX = 1A62h 


BX =4156h (AV') 
CX = handle for IRQ routine returned by 
Subfunction 42h 
Conflicts: None known. 
See Also: Function !Ah Subfunction 42h, Function [Ah Subfunction 63h 
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INTERRUPT 2Fh - Function 1Ah, Subfunction 63h 


UNINSTALL IRQ4 HANDLER 

Purpose: Remove a routine from the chain of interrupt handlers for IRQ4. 

Available on: All machines. Restrictions: AVATAR driver must be installed. 
Registers at call: Return Registers: n/a 

AX = 1A63h 


BX = 4156h (AV') 
CX = handle for IRQ routine returned by 
Subfunction 43h 
Conflicts: None known. 
See Also: Function 1Ah Subfunction 43h, Function 1Ah Subfunction 62h 


COURIERS.COM 


COURIERS is a TSR by PC Magazine, published in Volume 8 Number 19 (November 14, 1989). It provides serial 


port services for the ISTCLASS program to send binary files via MCI which was published in the same issue. 


INTERRUPT 14h - Function 80h 


INSTALLATION CHECK 

Purpose: Determine whether COURIERS is installed. 

Available on: Ail machines. Restrictions: none. 
Registers at call: Return Registers: 
AH = 80h AH = E8h if loaded 


Conflicts: Communications FOSSIL (see FOSSIL Function 7Eh). 


INTERRUPT 14h - Function 81h 
CHECK IF PORT BUSY 


Purpose: Determine port status. 


Available on: All machines. Restrictions; COURIERS.COM must be installed. 
Registers at call: Return Registers: 

AH = 81h AH = 00h port available 

AL = port number (1-4) lh port exists but already in use 


02h port nonexistent 
Details; COURIERS is a TSR utility by PC Magazine 
Conflicts: Video FOSSIL (chapter 5). 
See Also: Function 83h, Function 8Dh 


INTERRUPT 14h - Function 82h 
CONFIGURE PORT 


Purpose: Establish operating conditions for the specified serial port. 


Available on: All machines. Restrictions: COURIERS.COM must be installed. 
Registers at call: Return Registers: n/a 
AH = 82h 


AL = port number (1-4) 
BX = speed (bps) 
CX = bit flags: 

bit 0: enable input flow control 

bit 1; enable output flow control 

bit 2: use X.PC protocol (not 

yet implemented) 

Conflicts: Keyboard FOSSIL (see FOSSIL Function TEh). 
See Also: Function 8Ch, Standard BIOS Function 00h 
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INTERRUPT 14h - Function 83h 


START INPUT 

Purpose: Set up input buffers. 

Available on: All machines. Restrictions: COURIERS.COM must be installed. 
Registers at call: Return Registers: n/a 

AH = 83h 


ES:BX -> circular input buffer 
CX = length of buffer (should be at least 128 bytes 
if input flow control enabled) 
Conflicts: System FOSSIL (see FOSSIL Function 7Eh). 
See Also: Function 87h, Function 8Dh, FOSSIL Function 18h, 3com BAPI Function ASh 


INTERRUPT 14h - Function 84h 


READ CHARACTER 

Purpose: Read one character from the specified port, waiting if necessary. 

Available on: All machines, Restrictions: COURIERS.COM must be installed. 
Registers at call: Return Registers: 

AH = 84h ZF set if no characters available 


ZF clear 
AL = character 
AH = modem status bits: 
bit 7: set on input buffer overflow 
Conflicts: None known. 
See Also: Function 86h, Function 89h, Standard BIOS Function 02h 


INTERRUPT 14h - Function 85h 


FLUSH PENDING INPUT 

Purpose: Discard all pending input. 

Available on: All machines. Restrictions; COURIERS.COM must be installed, 
Registers at call: Return Registers: n/a 

AH = 85h 


Conflicts: None known. 
See Also: Function 88h, FOSSIL Function 0Ah 


INTERRUPT an - Function 86h 


START OUTPU : 
Purpose: Set up output buffering. 

Available on: All machines. Restrictions: COURIERS.COM must be installed, 

Registers at call: Return Registers: n/a 

AH = 86h 


ES:BX -> output buffer 

CX = length of output buffer 

Conflicts: None known. 

See Also: Function 83h, FOSSIL Function 19h, 3com BAPI Function A4h 


INTERRUPT 14h - Function 87h 


OUTPUT STATUS 

Purpose: Check output status. 

Available on: All machines. Restrictions: COURIERS.COM must be installed, 
Registers at call: Return Registers: 

AH = 87h AX = number of unsent characters 


Conflicts: None known. 
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INTERRUPT 14h - Function 88h 


ABORT OUTPUT 

Purpose: Halt output. 

Available on: Ali machines. Restrictions; COURIERS.COM must be installed. 
Registers at call: Return Registers: n/a 

AH = 88h 


Conflicts: None known. 
See Also: Function 85h, FOSSIL Function 09h 


INTERRUPT 14h - Function 89h 


SEND SINGLE CHARACTER 

Purpose: Send one character to the specified port. 

Available on: All machines. Restrictions; COURIERS.COM must be installed. 
Registers at call: Return Registers: n/a 

AH = 89h 


CL = character to send 
Conflicts: None known. 
See Also: Function 84h, Standard BIOS Function 01h 


INTERRUPT 14h - Function 8Ah 


SEND BREAK 

Purpose: Send BREAK character to the specified port. 

Available on: All machines. Restrictions; COURIERS.COM must be installed. 
Registers at call: Return Registers: n/a 

AH =8Ah 


Conflicts: None known. 
See Also: Function 89h, IBM/Yale EBIOS Function FAh 


INTERRUPT 14h - Function 8Ch 


SET SPEED 

Purpose; Establish port speed. 

Ayailable on: All machines. Restrictions: COURIERS.COM must be installed. 
Registers at call: Return Registers: n/a 

AH = 8Ch 


BX = speed in bps 
Conflicts: None known. 
See Also: Function 82h, Standard BIOS Function 00h 


INTERRUPT 14h - Function 8Dh 


DECONFIGURE PORT 

Purpose: Turn off all interrupts and modem control signals for the specified port. 

Available on: All machines. Restrictions: COURIERS.COM must be installed, 
Registers at call: Return Registers: n/a 

AH = 8Dh 


Conflicts: None known. 
See Also: Function 82h 


FOSSIL. (Fido/Opus/Seadog Standard Interface Level) 

FOSSIL is a driver which allows hardware-independent access to serial ports and (through extensions which a 
FOSSIL allows to be loaded) other hardware, permitting software to run unchanged on MSDOS machines which are 
not 100% IBM-compatible. The FOSSIL specification grew out of the Generic Fido(tm) driver when the authors of 
the Seadog and Opus systems adopted and extended the set of calls supported by the drivers. 
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INTERRUPT 11h - Function BCh 
BNU - INSTALLATION CHECK 


Purpose: Determine whether the BNU implementation of FOSSIL is installed, 


Available on: All machines. Restrictions: none. 

Registers at call: Return Registers: 

AH =BCh AX = 1954h 

DX = 1954h ES:DX -> entry point of driver (instead of INT 14) 


Conflicts: None known. 


INTERRUPT 14h - Function 00h 


INITIALIZE 
Purpose: Establish operating conditions for the specified serial port. 
Available on: All machines, Restrictions; FOSSIL software must be installed. 
Registers at call: Return Registers: 
AH = 00h AH = RS-232 status code bits: 
AL = initializing parameters (see Table 7-1) 0: RDA - input data is available in buffer 
DX = port number (0-3 or FFh if only performing 1: OVRN - data has been lost 
non-I/O setup) 5: THRE - room is available in output buffer 


6: TSRE - output buffer empty 
AL = modem status bits: 
3: always 1 
7: DCD - carrier detect 
Conflicts: None known. 
See Also: Function 05h, COURIERS.COM Function 82h 


INTERRUPT 14h - Function 02h 
RECEIVE CHARACTER WITH WAIT 


Purpose: Read one character from the specified port, waiting if necessary. 


Available on: All machines. Restrictions: FOSSIL software must be installed, 
Registers at call: Return Registers: 

AH = 02h AL = character received 

DX = port number (0-3) AH = 00h 


Conflicts: SERIAL - Read Character From Port. 
See Also: Standard BIOS Function Oth 


INTERRUPT 14h - Function 04h 


INITIALIZE DRIVER 
Purpose: Prepare the specified serial port for use. 
Available on: All machines. Restrictions: FOSSIL software must be installed. 
Registers at call: Return Registers: 
AH = 04h AX = 1954h (if successful) 
DX = port number BL = maximum function number supported (excluding 
optionally BX = 4F50h 7Eh and above) 
ES:CX -> byte to be set upon “C BH = revision of FOSSIL specification supported 


DIR is raised 


Details: The word at offset 6 in the interrupt handler contains 1954h, and the following byte contains the maximum 


function number supported. 
Conflicts: Standard BIOS - Extended Initialize, MultiDOS Plus IODRV - Initialize Port (chapter 16). 
See Also: Function 05h, Function 1Ch 
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INTERRUPT 14h - Function 05h 


DEINITIALIZE DRIVER 

Purpose: Deactivate FOSSIL driver for the specified port and perform cleanup, such as unhooking interrupt vectors. 
Available on: All machines. Restrictions: FOSSIL software must be installed. 
Registers at call: Return Registers: none 

AH = 05h 


DX = port number 
Details: DTR is not affected. 


Conflicts: Standard BIOS Extended Communication Port Control, MultiDOS Plus IODRV Read Character from 


Port (chapter 16). 
See Also: Function 00h, Function 04h, Function 1Dh, COURIERS.COM Function 8Dh 


INTERRUPT 14h - Function 06h 


RAISE/LOWER DTR 

Purpose: Control level of the Data Terminal Ready control signal. 

Available on: All machines. Restrictions: FOSSIL software must be installed. 
Registers at call: Return Registers: n/a 

AH = 06h 

DX = port 


AL= 00h =lower DTR 

Olh =raise DTR 
Conflicts: MultiDOS Plus IODRV - Write Character to Port (chapter 16). 
See Also: Function 1Ah 


INTERRUPT 14h - Function 07h 
RETURN TIMER TICK PARAMETERS 


Purpose: Determine information about tick-timer settings. 


Available on: All machines. Restrictions: FOSSIL software must be installed. 
Registers at call: Return Registers: 
AH = 07h AL = timer tick interrupt number 


AH = ticks per second on interrupt number in AL 
DX = approximate number of milliseconds per tick 
Conflicts: MultiDOS Plus IODRV - Get Port Status (chapter 16). 
See Also: Function 16h 


INTERRUPT 14h - Function 08h 
FLUSH OUTPUT BUFFER WAITING TILL ALL OUTPUT IS DONE 


Purpose: Empty all pending output data to the specified port. 


Available on: All machines. Restrictions: FOSSIL software must be installed. 
Registers at call: Return Registers: n/a 
AH = 08h 


DX = port number 
Conflicts: MultiDOS Plus 4.0 IODRV - Get and Reset Port Line Status (chapter 16). 
See Also: Function 09h 


INTERRUPT 14h - Function 09h 
PURGE OUTPUT BUFFER THROWING AWAY ALL PENDING OUTPUT 


Purpose: Discard all pending output for the specified port. 


Available on: All machines. Restrictions: FOSSIL software must be installed. 
Registers at call: Return Registers: n/a 
AH = 09h 


DX = port number 
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Conflicts: MultiDOS Plus IODRV - Reset Port Status (chapter 16). 
See Also: Function 08h, Function 0Ah, COURIERS.COM Function 88h 


INTERRUPT 14h - Function 0Ah 
PURGE INPUT BUFFER THROWING AWAY ALL PENDING INPUT 


Purpose: Discard all pending input for the specified port. 


Available on: All machines. Restrictions: FOSSIL software must be installed. 
Registers at call: Return Registers: n/a 
AH =0Ah 


DX = port number 
Conflicts: None known. 
See Also: Function 09h, COURIERS.COM Function 85h 


INTERRUPT 14h - Function OBh 


TRANSMIT NO WAIT 

Purpose: Start transmitting a character out the specified port, without waiting for its transmission to complete. 
Available on: All machines, Restrictions: FOSSIL software must be installed. 
Registers at call: Return Registers: 

AH = 0Bh AX = 0000h character not accepted 

AL = character 0001h character accepted 


DX = port number 
Conflicts: None known. 
See Also: Standard BIOS Function 01h 


INTERRUPT 14h - Function 0Ch 
NON-DESTRUCTIVE READ AHEAD 


Purpose: Peek at next input character without removing it from the input buffer. 


Available on: All machines, Restrictions: FOSSIL software must be installed. 
Registers at call: Return Registers: 

AH = 0Ch AX = FFFFh character not available 

DX = port number O0xxh character xx available 

Conflicts: None known. 

See Also: Function 20h 


INTERRUPT 14h - Function ODh 
KEYBOARD READ WITHOUT WAIT 


Purpose: Obtain keyboard input, if available (similar to INT 16h function). 


Available on: All machines. Restrictions: FOSSIL software must be installed. 
Registers at call; Return Registers: 
AH =0Dh AX = FFFFh character not available 


xxyyh standard IBM-style scan code 
Conflicts: None known. 
See Also: Function OEh, INT 16h Function 01h (chapter 2) 


INTERRUPT 14h - Function 0Eh 


KEYBOARD READ WITH WAIT 

Purpose: Obtain keyboard input, waiting until a keystroke is available if necessary (similar to INT 16h function). 
Available on: All machines, Restrictions: FOSSIL software must be installed. 
Registers at call: Return Registers: 

AH =0Eh AX = xxyyh standard IBM-style scan code 


Conflicts: None known. 
See Also: Function 0Dh, INT 16h Function 00h (chapter 2) 
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INTERRUPT 14h - Function 0Fh 
ENABLE/DISABLE FLOW CONTROL 


Purpose: Set flow control protocol to use, if any, on the specified port. 


Available on: All machines. Restrictions: FOSSIL software must be installed. 
Registers at call: Return Registers: n/a 
AH = OFh 


AL = bit mask describing flow control requested: 
0: xon/xoff on transmit (watch for xoff 
while sending) 
1: CTS/RTS (CTS on transmit/RTS on 
receive) 
2: reserved 
3: xon/xoff on receive (send xoff when 
buffer near full) 
4-7: all 1 
DX = port number 
Conflicts: None known. 
See Also: Function 10h 


INTERRUPT 14h - Function 10h 
EXTENDED “C/4K CHECKING AND TRANSMIT ON/OFF 


Purpose: Control user-interrupt checking actions for the specified port. 


Available on: All machines. Restrictions: FOSSIL software must be installed. 
Registers at call: Return Registers: n/a 

AH = 10h 

AL = bit mask: 


0: enable/disable “C/AK checking 
1; enable/disable the transmitter 
DX = port number 
Conflicts: None known. 
See Also: Function OFh 


INTERRUPT 14h - Function 11h 
SET CURRENT CURSOR LOCATION 


Purpose: Establish cursor position (similar to INT 10h function). 


Available on: All machines. Restrictions: FOSSIL software must be installed. 
Registers at call: Return Registers: n/a 

AH = 11h 

DH = row 

DL = column 


Details: This is the same as INT 10h Function 02h (chapter 5). 
Conflicts: None known. 
See Also: Function 12h 


INTERRUPT 14h - Function 12h 
READ CURRENT CURSOR LOCATION 


Purpose: Determine cursor position (similar to INT 10h function). 


Available on: All machines. Restrictions: FOSSIL software must be installed. 
Registers at call: Return Registers: 
AH = 12h DH = row 

DL = column 


Details: This is the same as INT 10h Function 03h (chapter 5). 
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Conflicts; None known. 
See Also: Function 11h 


INTERRUPT 14h - Function 13h 
SINGLE CHARACTER ANSI WRITE TO SCREEN 


Purpose: Writes character at current cursor position. 


Available on: All machines. Restrictions: FOSSIL software must be installed. 
Registers at call: Return Registers: n/a 
AH = 13h 


AL = character 

Details: This function should not be called at times when it is unsafe to call DOS. 
Conflicts: None known. 

See Also: Function 15h 


INTERRUPT 14h - Function 14h 
ENABLE OR DISABLE WATCHDOG PROCESSING 


Purpose: Control watchdog timer actions for the specified port, 


Available on: All machines. Restrictions: FOSSIL software must be installed. 
Registers at call: Return Registers: n/a 
AH = I4h 
AL = 01h enable watchdog 
00h disable watchdog 


DX = port number 
Conflicts: None known. 


INTERRUPT 14h - Function 15h 
WRITE CHARACTER TO SCREEN USING BIOS SUPPORT ROUTINES 


Purpose: Write a character at the current cursor position (similar to INT 10h function). 


Available on: All machines. Restrictions: FOSSIL software must be installed. 
Registers at call: Return Registers: n/a 
AH = 15h 


AL = character 
Conflicts: None known. 
See Also: Function [3h 


INTERRUPT 14h - Function 16h 
INSERT/DELETE FUNCTION FROM TIMER TICK CHAIN 


Purpose: Add a function to, or remove a function from, the interrupt chain for the system timer. 


Available on: All machines. Restrictions: FOSSIL software must be installed. 
Registers at call: Return Registers: 
AH = 16h AX = status: 
AL= 00h = delete function 0000h successful 
Oh = add function 0001h unsuccessful 


ES:DX -> routine to call 
Conflicts: None known. 
See Also: Function 07h 


INTERRUPT 14h - Function 17h 
REBOOT SYSTEM 


Purpose: Reboot the system, performing either a cold boot (with self-test) or a warm boot. 
Available on: All machines. Restrictions: FOSSIL software must be installed. 
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Registers at call: Return Registers: n/a 
AH = 17h 
AL= 00h =cold boot 
01h = warm boot 
Conflicts: None known, 
See Also: INT 19h (chapter 2) 


INTERRUPT 14h - Function 18h 


READ BLOCK 

Purpose: Read a block of characters from the specified port, waiting if necessary. 

Available on: All machines. Restrictions: FOSSIL software must be installed. 
Registers at call: Return Registers: 

AH = 18h AX = number of characters transferred 


CX = maximum number of characters to transfer 

DX = port number 

ES:DI -> user buffer 

Conflicts: None known. 

See Also: Function 19h, COURIERS.COM Function 83h, IBM/Yale EBIOS Function FFh Subfunction 02h, Novell 
NASI Function 01h 


INTERRUPT 14h - Function 19h 
WRITE BLOCK 
Purpose: Write a block of characters to the specified port. 

Available on: All machines. Restrictions: FOSSIL software must be installed, 
Registers at call: Return Registers: 

AH = 19h AX = number of characters transferred 

CX = maximum number of characters to transfer 

DX = port number 
ES:DI -> user buffer 

Conflicts: None known. 

See Also: Function 18h, COURIERS.COM Function 86h, Novell NASI Function 00h 


INTERRUPT 14h - Function 1Ah 





BREAK BEGIN OR END 

Purpose: Start or stop sending a BREAK signal on the specified port. 

Available on: All machines. Restrictions: FOSSIL software must be installed. 
Registers at call: Return Registers: n/a 

AH = [Ah 


AL = 00h stop sending ‘break’ 
Olh start sending ‘break’ 
DX = port number 
Conflicts: None known. 
See Also: Function 06h, COURIERS.COM Function 8Ah, IBM/Yale EBIOS Function FAh 


INTERRUPT 14h - Function 1Bh 
RETURN INFORMATION ABOUT THE DRIVER 


Purpose: Obtain driver information. 


Available on: All machines. Restrictions: FOSSIL software must be installed. 
Registers at call: Return Registers: 

AH = 1Bh AX = number of characters transferred 

DX = port number CX = 3058h ("0X") (X00 FOSSIL only) 

CX = size of user buffer DX = 2030h ("0") (X00 FOSSIL only) 


ES:DI -> user buffer for driver info (Table 7-3) 
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Conflicts: None known. 


Table 7-3. Format of driver info: 


Offset Size Description 

00h WORD size of structure in bytes 

02h BYTE FOSSIL spec to which driver conforms 
03h BYTE revision level of this specific driver 
04h DWORD pointer to ASCIZ identification string 
08h WORD size of the input buffer 

OAh WORD number of bytes left in buffer 

0Ch WORD size of the output buffer 

OEh WORD number of bytes left in buffer 

10h BYTE width of screen 

1lh BYTE length of screen 

12h BYTE actual baud rate, computer to modem 


INTERRUPT 14h - Function 1Ch 
X00 - ACTIVATE PORT 


Purpose: Establish operating conditions for the specified serial port, 


Available on: All machines. Restrictions: The X00 implementation of the FOSSIL 
software must be installed. 
Registers at call: Return Registers: 
AH =1Ch AX = 1954h if successful 
DX = port number BL = maximum function number supported (not 
including 7Eh and above) 


BH = revision of FOSSIL specification supported 
Details: This is a duplicate of function 04h, so that that function may be made compatible with the PS/2 BIOS ina 
future release. 
Conflicts: None known. 
See Also: Function 04h, Function 1Dh 


INTERRUPT 14h - Function 1Dh 
X00 - DEACTIVATE PORT 


Purpose: Deactivate FOSSIL driver for the specified port and perform any necessary cleanup, such as unhooking 
interrupt vectors. 


Available on: All machines. Restrictions: The X00 implementation of the FOSSIL 
software must be installed, 

Registers at call: Return Registers: n/a 

AH=1Dh 


DX = port number 

Details: This is a duplicate of Function 05h, so that that function may be made compatible with the PS/2 BIOS ina 
future release, Ignored if the port was never activated with Function 04h or Function 1Ch, 

Conflicts: None known. 

See Also: Function 05h, Function 1Ch 


INTERRUPT 14h - Function 1Eh 
X00 - EXTENDED LINE CONTROL INITIALIZATION 


Purpose: Establish operating conditions for the specified serial port. 


Available on: All machines. Restrictions: The X00 implementation of the FOSSIL 
software must be installed. 
Registers at call: Return Registers: 


AH = JEh AX = port status code (see Table 7-2) 
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AL = break status: 

00h if break 

O1h if no breakBH = parity: 

00h no parity 

Olh odd parity 

02h even parity 

03h stick parity odd 

04h stick parity even 
BL = number of stop bits: 

00h one stop bit 

Oth two stop bits (1.5 if 5 bit word length) 
CH = word length: 

00h 5 bits 

Oth 6 bits 

02h 7 bits 

03h 8 bits 
CL = bps rate: 

00h 110 

Olh 150 

02h 300 

03h 600 

04h 1200 

05h 2400 

06h 4800 

07h 9600 

08h 19200 
DX = port number 
Details: This function is intended to exactly emulate the PS/2 BIOS Function 04h call. If the port was locked at X00 
Joad time, the appropriate parameters are ignored. 
Conflicts: None known. 
See Also: Function 00h, Standard BIOS Function 04h 


INTERRUPT 14h - Function 1Fh 
X00 - EXTENDED SERIAL PORT STATUS/CONTROL 


Purpose: Establish additional operating conditions for the specified serial port. 





Available on: All machines, Restrictions: The X00 implementation of the FOSSIL 
software must be installed. 
Registers at call: Return Registers: 
AH = 1Fh vary with function 
AL = function: 
00h read modem control register: BL = modem control register (see below) 
AH = status 
O1h write modem control register: AX = status 
BL = modem control register: DX = port number 


bit 0: data terminal ready 

bit 1: request to send 

bit 2: OUT! 

bit 3: OUT2 (interrupts) enabled 

bit 4: LOOP 

bits 5-7 reserved 
Details: This function is intended to exactly emulate the PS/2 BIOS Function 05h call. X00 forces BL bit 3 set 
(interrupts cannot be disabled). 
Conflicts: None known. 
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See Also: Function 00h, Standard BIOS Function 05h 


INTERRUPT 14h - Function 20h 
X00 - DESTRUCTIVE READ WITH NO WAIT 


Purpose: Read one character, if available, from the specified port; does not wait for character to arrive, 


Available on: All machines. Restrictions: The X00 implementation of the FOSSIL 
software must be installed. 

Registers at call: Return Registers: 

AH = 20h AH = 00h if character was available 

DX = port number AL = next character (removed from receive buffer) 


AX = FFFFh if no character available 
Conflicts: MultiDOS Plus - Initialize Port (chapter 16), Alloy MW386 (chapter 18). 
See Also: Function 0Ch, Function 21h 


INTERRUPT 14h - Function 21h 
X00 - STUFF RECEIVE BUFFER 


Purpose: Insert the specified character at end of receive buffer as if it had just arrived from the serial port; all normal 
receive processing (XON/XOFF, 4C/AK) is performed on the character. 


Available on: All machines. Restrictions: The X00 implementation of the FOSSIL 
software must be installed. 

Registers at call: Return Registers: n/a 

AH =2Ih 


AL = character 

DX = port number 

Details: This function is fully re-entrant. 

Conflicts: Alloy MW386 (chapter 18), MultiDOS Plus - Transmit Character (chapter 16), 
See Also: Function 20h 


INTERRUPT 14h - Function 7Eh 
INSTALL AN EXTERNAL APPLICATION FUNCTION 


Purpose: Installs extended capabilities of FOSSIL, 


Available on: All machines. Restrictions: FOSSIL software must be installed. 
Registers at call: Return Registers: 
AH =7Eh AX = 1954h 
AL = code for external application (80h-BFh): BL = code assigned to application (same as input AL) 
80h reserved for communications FOSSIL DH = 00h failed 
81h video FOSSIL O1h successful 


82h reserved for keyboard FOSSIL 
83h reserved for system FOSSIL 
ES:DX -> entry point 
Conflicts: None known. 
See Also: Function 7Fh, Function 81h Subfunction 00h (chapter 5) 


INTERRUPT 14h - Function 7Fh 
REMOVE AN EXTERNAL APPLICATION FUNCTION 


Purpose: De-installs specified extended capability of FOSSIL. 


Available on: All machines. Restrictions: FOSSIL software must be installed. 
Registers at call: Return Registers: 
AH = 7Fh AX = 1954h 
AL = code assigned to external application BL = code assigned to application (same as input AL) 
(see Function 7Eh) DH = 00h failed 
ES:DX -> entry point O1h successful 


Conflicts: None known. 
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See Also: Function 7Eh 
IBM/Yale EBIOS SERIAL 1/0 
INTERRUPT 14h - Function F4h, Subfunction FFh 


INSTALLATION CHECK 
Purpose: Determine whether EBIOS has been installed. 
Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AX = F4FFh CF clear if present 
DX = port (00h-03h) AX = 0000h 

CF set if not present 

AX <> 0000h 


Conflicts: None known. 


INTERRUPT 14h - Function F9h 

REGAIN CONTROL 

Purpose: Recapture the interrupt vector (if hooked by another application) and perform any other actions needed to 
begin I/O processing on the specified serial port. 


Available on: All machines. Restrictions: EBJOS must be installed. 
Registers at call: Return Registers: n/a 
AH = F9h 


DX = port (00h-03h) 
Conflicts: None known. 


INTERRUPT 14h - Function FAh 


SEND BREAK 

Purpose: Send BREAK character on the specified serial port. 

Available on: All machines. Restrictions: EBIOS must be installed. 
Registers at call: Return Registers: n/a 

AH = FAh 


DX = port (00h-03h) 
Conflicts: None known, 
See Also: FOSSIL Function 1!Ah, COURIERS.COM Function 8Ah 


INTERRUPT 14h - Function FBh 
SET OUTGOING MODEM SIGNALS 


Purpose: Establish levels of modem control signals for the specified port. 


Available on: All machines. Restrictions: EBIOS must be installed. 
Registers at call: Return Registers: n/a 
AH = FBh 


AL = modem control register: 
bit 0: data terminal ready 
1: request to send 
2: OUT 
3; OUT2 
4: loopback 
bits 5-7 unused 
DX = port (00h-03h) 
Conflicts: None known. 
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INTERRUPT 14h - Function FCh 


READ CHARACTER, NO WAIT 

Purpose: Obtain a character, if available, from the specified port; will not wait if no character available. 
Available on: All machines. Restrictions: EBIOS must be installed. 
Registers at call: Return Registers: 

AH =FCh AH = RS232 status bits (see Table 7-2) 
DX = port (00h-03h) AL = character 


Conflicts: None known. 
See Also: Function FFh Subfunction 02h, Standard BIOS Function 02h, FOSSIL Function 0Ch 


INTERRUPT 14h - Function FDh, Subfunction 02h 





READ STATUS 

Purpose: Determine how many characters are available in the input buffer. 

Available on: All machines. Restrictions: EBJOS must be installed. 
Registers at call: Return Registers: 

AX = FDO02h CX = number of characters available 


Conflicts; None known. 


INTERRUPT 14h - Function FFh, Subfunction 02h 


BUFFERED READ 

Purpose: Read all available characters up to the specified limit. 

Available on: All machines. Restrictions: EBIOS must be installed. 
Registers at call: Return Registers: 

AX = FFO2h CX = number of characters read 

CX = length 


DX = port (00h-03h) 

ES:BX -> buffer 

Conflicts: None known. 

See Also: Function FCh, FOSSIL Function 18h, COURIERS.COM Function 83h, 3com BAPI Function ASh 


Interconnections Inc. TES 
TES is a network serial port emulation program by Interconnections, Inc. 


INTERRUPT 14h - Function Adh 
INSTALLATION CHECK/STATUS REPORT 


Purpose: Determine whether TES is installed. 


Available on: All machines. Restrictions: Status report is only valid if TES is 
installed, 
Registers at call: Return Registers: 
AH = AOh CF clear if successful 
CX = FFFFh AX = 5445h (‘TE’) 
CX <> FFFFh 


DX = port number 
CE set on error 
Conflicts: 3com BAPI SERIAL I/O. 
See Also: Function Alh 


INTERRUPT 14h - Function Aih 
GET LIST OF SESSIONS WITH STATUS 


Purpose: Determine the currently-active sessions and the status of each. 
Available on: All machines. Restrictions: TES must be installed. 


Registers at call: 
AH=Alh 


Table 7-4. Format of status array entry: 


Offset Size Description 
00h BYTE status 
Oth WORD offset of name 


Conflicts: 3com BAPI SERIAL I/O. 
See Also: Function A2h, Function A3h 


INTERRUPT 14h - Function A2h 
GET LIST OF SERVER NAMES 


Purpose: Determine the names of the servers TES is using. 
Available on: All machines. 

Registers at call: 

AH= A2h 


Conflicts: None known. 
See Also: Function Alh 


INTERRUPT 14h - Function A3h 
START A NEW SESSION 


Purpose: Create a new connection. 
Available on: All machines. 

Registers at call: 

AH=A3h 

ES:SI -> unknown, probably a data structure. 


Conflicts: None known. 
See Also: Function Alh, Function A4h, Function A6h 


INTERRUPT 14h - Function A4h 
HOLD CURRENTLY ACTIVE SESSION 


Purpose: Temporarily suspend a session, 
Available on: All machines. 

Registers at call: 

AH = A4h unknown, 

Conflicts: 3com BAPI SERIAL I/O. 

See Also: Function A3h, Function ASh 


INTERRUPT 14h - Function ASh 
RESUME A SESSION 


Purpose: Restart a session which was previously suspended. 
Available on: All machines. 

Registers at call: 

AH = ASh 

AL = session number 

Conflicts: 3com BAPI SERIAL 1/0. 

See Also: Function A4h, Function Aéh 
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Return Registers: 
CX = number of active sessions 
ES:SI -> status array (Table 7-4) 


Restrictions: TES must be installed, 
Return Registers: 
CX = number of servers 


ES:SI -> array of offsets from ES for server names 


Restrictions: TES must be installed. 
Return Registers: 
CF clear if successful 
AX = 5445h (‘TE’) 
CX <> FRFFh 
DX = port number 
CF set on error 


Restrictions: TES must be installed. 
Return Registers: unknown. 


Restrictions: TES must be installed. 
Return Registers: unknown. 
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INTERRUPT 14h - Fi 
DROP A SESSION 


unction A6h 


Purpose: Terminate a connection. 


Available on: All machines. 


Registers at call: 
AH=A6h 
AL & session number 


Conflicts: 3com BAPI 
See Also: Function A3| 


INTERRUPT 14h - Fi 
SWITCH TO NEXT ACTI 


Purpose: Select a diffe 
Available on: All mac! 
Registers at call: 

AH = A7h 

others unknown. 
Conflicts: 3com BAPI 
See Also: Function A3| 


INTERRUPT 14h - Fi 


Restrictions: TES must be installed. 
Return Registers: 
AH = status: 
00h successful 
else error 
SERIAL I/O. 
h, Function ASh 


unction A7h 
VE SESSION 


rent connection to be the current connection on which commands and I/O are performed. 
ines. Restrictions: TES must be installed. 
Return Registers: unknown. 


SERIAL 1/0. 
h, Function A5h 


unction A8h 


SEND STRING TO COMMAND INTERPRETER 
Purpose: Interpret a command string as if it had been typed by the user, 


Available on: All mac! 
Registers at call: 
AH = A8h 





Restrictions: TES must be installed. 
Return Registers: unknown. 


hines, 


AL = 00h no visible response 
ES:SI -> ASCIZ command 
Conflicts: None known. 


Novell NASI/NACS and Ungermann-Bass Net One 


Novell NASI, Novell NACS, and Ungermann-Bass Net One provide network serial port emulation through INT 6Bh. 


‘The functions described in this section are sometimes referred to as the “generic INT 6Bh interface". 


INTERRUPT 6Bh - Function 00h 


BUFFERED WRITE 
Purpose: Write one or 


Available on: All machines. 


Registers at call: 

AX = 0000h 

CX = length 

ES:BX -> buffer 
Conflicts: "Saddam" v: 


more characters to the emulated serial port. 
Net One must be installed. 


Return Registers: 
CX = number of bytes written 


irus (chapter 34) 


See Also: Function 01h, FOSSIL Function 19h 
INTERRUPT 6Bh - Function 01h 


BUFFERED READ 


Purpose: Read one or more characters from the emulated serial port. 


Available on: All machines. 


Net One must be installed. 


Restrictions: Novell NASI/NACS or Ungermann-Bass 


Restrictions: Novell NASI/NACS or Ungermann-Bass 


Serial /O 7-23 


Registers at call: Return Registers: 

AX = 0100h CX = number of bytes read 

CX = length of buffer 

ES:BX -> buffer 

Conflicts: "Saddam" virus (chapter 34) 

See Also: Function 00h, FOSSIL Function 18h, IBM/Yale EBIOS Function FFh Subfunction 02h 


INTERRUPT 6Bh - Function 02h 


INSTALLATION CHECK 

Purpose: Determine whether Novell NASI/NACS or Ungermann-Bass Net One is installed, 
Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 

AH = 02h AL = 00h if present and OK 
AL nonzero 


Conflicts: "Saddam" virus (chapter 34) 
See Also: Function 07h 


INTERRUPT 6Bh - Function 06h 


CONTROL 
Purpose: Execute a control action on a connection, such as sending a break signal or disconnecting. 
Available on: All. machines, Restrictions: Novell NASI/NACS or Ungermann-Bass 
Net One must be installed. 
Registers at call: Return Registers:n/a 
AX = 0600h 
CX = command 
02h send break 
04h disconnect 
06h hold 
Conflicts: "Saddam" virus (chapter 34) 
INTERRUPT 6Bh - Function 07h 
GET STATUS 
Purpose: Determine whether a connection is presently active. 
Available on: All machines. Restrictions: Novell NASI/NACS or Ungermann-Bass 
Net One must be installed. 
Registers at call: Return Registers: 
AX =0700h CH <> 00h if connection active 


Conflicts: "Saddam" virus (chapter 34) 
See Also: Function 02h 
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Chapter w 8 


MS-DOS and Compatibles 


This chapter tabulates the interrupts used by MS-DOS since version 1.0; since most of these routines have been 
widely documented elsewhere, discussion of their use is kept to a minimum. 

The chapter is divided into three sections. Within each section or subsection, functions are listed by numeric se- 
quence of the interrupt first, then by function number within each interrupt, and by subfunction within each function. 
In the few cases in which multiple versions of the same subfunction exist, they are listed in alphabetic sequence by 
identifier. 

The first section contains the functions provided by the MS-DOS kernel, except for those on interrupt 2Fh (the 
multiplex interrupt). The second section contains the multiplex interrupt functions provided by both the kernel and 
various DOS utilities, as well as two non-multiplex calls provided by PRINT.COM. This section is divided into sub- 
sections by the program providing the services. Finally, the third section details calls provided by various MS-DOS- 
compatible operating systems. 





INTERRUPT 20h 

TERMINATE PROGRAM 

Purpose: Ends current process and returns to parent (usually the command interpreter), 
Available on: All versions of DOS. Restrictions: none. 

Registers at call: Return Registers: never returns 


CS = PSP segment 

Details: Microsoft recommends using INT 21h Function 4Ch for DOS 2.0 and higher. Execution continues at the ad- 
dress stored in INT 22h after DOS performs whatever cleanup is necessary (closing files, etc). If the PSP is its own 
parent, the process’s memory is not freed; if INT 22h additionally points into the terminating program, the process is 
effectively not terminated. This feature is used by COMMAND.COM. 

Conflicts: Minix Send/Receive Message (chapter 36). 

See Also: INT 21h Functions 00h and 4Ch 


INTERRUPT 21h - Function 00h 
TERMINATE PROGRAM 


Purpose: Ends current process and returns to parent (usually command interpreter). 
Available on: All versions of DOS. ‘ 
Restrictions: Not supported by MS Windows 3.0 
DOSX.EXE DOS extender. 

Registers at call: Return Registers: n/a 

AH = 00h 

CS = PSP segment 

Details: Microsoft recommends using INT 21h Function 4Ch for DOS 2.0 and higher. Execution continues at the ad- 
dress stored in INT 22h after DOS performs whatever cleanup may be necessary (closing files, etc). If the PSP is its 
own parent, the process’s memory is not freed; if INT 22h additionally points into the terminating program, the pro- 
cess is effectively not terminated. 

Conflicts: None known. 

See Also: Functions 26h, 31h, and 4Ch, INT 20h, INT 22h 
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INTERRUPT 21h - Function Oth 
READ CHARACTER FROM STANDARD INPUT, WITH ECHO 


Purpose: Reads one character from standard input, and echoes the character to standard output, 


Available on: All versions of DOS. Restrictions: none. 
Registers at call: Return Registers: 
AH=0lh AL = character read 


Details: Control-C and Control-Break are checked, and INT 23h is executed if either was pressed. The character is 
echoed to standard output. Standard input is always the keyboard and standard output the screen under DOS 1.x, but 
they may be redirected under DOS 2.0 and higher. 

Conflicts: None known. 

See Also: Functions 06h, 07h, 08h, and OAh 


INTERRUPT 21h - Function 02h 
WRITE CHARACTER TO STANDARD OUTPUT 


Purpose: Writes one character to standard output. 


Available on: All versions of DOS. Restrictions: none. 
Registers at call: Return Registers: n/a 
AH = 02h 


DL = character to write 

Details: Control-C and Control-Break are checked, and INT 23h is executed if either was pressed. Standard output is 
always the screen under DOS 1.x, but may be redirected under DOS 2+. 

Conflicts: None known. 

See Also: Function 06h, Function 09h 


INTERRUPT 21h - Function 03h 
READ CHARACTER FROM STDAUX 


Purpose: Reads one character from the predefined STDAUX handle, waiting for it if none is available. Not often 
used. 


Available on: All versions of DOS. Restrictions: none. 
Registers at call: Return Registers: 
AH = 03h AL = character read 


Details: The keyboard is checked for Control-C or Control-Break, and INT 23h is executed if either is detected, 
The STDAUX handle usually refers to the AUX device, which is the first serial port, but it may be redirected 
under DOS 2.0 or higher. 
Conflicts; None known. 
See Also: Function 04h, INT 14h Function 02h (chapter 7) 


INTERRUPT 21h - Function 04h 
WRITE CHARACTER TO STDAUX 


Purpose: Writes one character to the predefined STDAUX handle. Not often used. 


Available on: All versions of DOS. Restrictions: none. 
Registers at call: Return Registers: n/a 
AH = 04h 


DL = character to write 
Details: The keyboard is checked for Control-C or Control-Break, and INT 23h is executed if either is detected. 
If STDAUX is busy, this function will wait until it becomes free. 
The STDAUX handle usually refers to the AUX device, which is the first serial port, but it may be redirected 
under DOS 2,0 and higher. 
Conflicts: None known. 
See Also: Function 03h, INT 14h Function 01h (chapter 7) 
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INTERRUPT 2th - Function 05h 
WRITE CHARACTER TO PRINTER 


Purpose: Write one character to the predefined STDPRN handle. 


Available on: All versions of DOS. Restrictions: none. 
Registers at call: Return Registers: n/a 
AH = 05h 


DL = character to print 
Details: The keyboard is checked for Control-C or Control-Break, and INT 23h is executed if either is detected. 
The STDPRN handle normally refers to the PRN device (the first parallel port), but it may be redirected under 
DOS 2.0 and higher. If the printer is busy, this function will wait. 
Conflicts: None known. 
See Also: INT 17h Function 00h (chapter 3) 


INTERRUPT 21h - Function 06h 


DIRECT CONSOLE OUTPUT 

Purpose: Write one character to the predefined STDOUT handle. 

Available on: All versions of DOS. Restrictions: none. 
Registers at call: Return Registers: n/a 
AH = 06h 


DL = character (except FFh) 

Details: This call does not check for Control-C or Control-Break. 
Conflicts: None known. 

See Also: Functions 02h and 09h 


INTERRUPT 21h - Function 06h, Subfunction FFh 


DIRECT CONSOLE INPUT 

Purpose: Reads one character, if available, from the predefined STDIN handle; if no character is available, it returns 
immediately. 

Available on: All versions of DOS. Restrictions: none. 

Registers at call: Return Registers: 

AH = 06h ZF set if no character available 

DL =FFh ZF clear if character available 


AL = character read 
Details: Does not check for Control-C or Control-Break. 
If the returned character is 00h, the user pressed a key with an extended keycode, which will be returned by the 
next call of this function. 
Conflicts: None known. 
See Also: Function OBh 


INTERRUPT 21h - Function 07h 
DIRECT CHARACTER INPUT WITHOUT ECHO 


Purpose: Reads one character from the predefined STDIN handle; if no character is available, it waits for the next 


keystroke. 

Available on: All versions of DOS. Restrictions: none. 

Registers at call: Return Registers: 

AH = 07h AL = character read from standard input 


Details: This function does not check for Control-C or Control-Break, and does not echo the returned character to 
STDOUT. 

If the interim console flag is set (see Function 63h Subfunction Oth), partially-formed double-byte characters 
may be returned. 
Conflicts: None known. 
See Also: Functions 01h, 06h, 08h, and OAh 
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INTERRUPT 21h - Function 08h 
CHARACTER INPUT WITHOUT ECHO 


Purpose: Reads one character from the predefined STDIN handle; if no character is available, it waits for the next 


keystroke. 

Available on: All versions of DOS. Restrictions: none. 

Registers at call: Return Registers: 

AH = 08h AL = character read from standard input 


Details: Control-C and Control-Break are checked, and INT 23h is executed if either was pressed. 
If the interim console flag is set (see Function 63h Subfunction Oth), partially-formed double-byte characters 
may be returned. 
Conflicts: None known. 
See Also: Function 01h, Function 06h, Function 07h, Function OAh, Function 64h 


INTERRUPT 2th - Function 09h 
WRITE STRING TO STANDARD OUTPUT 


Purpose: Writes '$'-terminated string to STDOUT. 


Available on: All versions of DOS. Restrictions: none. 
Registers at call: Return Registers: n/a 
AH = 09h 


DS:DX -> '$'-terminated string 

Details: Control-C and Control-Break are checked, and INT 23h is called if either was pressed. 
Conflicts: None known. 

See Also: Function 02h, Function 06h for output 


INTERRUPT 21h - Function 0Ah 


BUFFERED INPUT 

Purpose: Obtains keyboard input from STDIN. 

Available on: All versions of DOS. Restrictions: none. 
Registers at call: Return Registers: 

AH = 0Ah buffer filled with user input 


DS:DX -> buffer (Table 8-1) 
Details: Control-C and Control-Break are checked, and INT 23h is called if either is detected. 
If the maximum buffer size (Table 8-1) is set to 00h, this call returns immediately without reading any input. 
Conflicts: WCED v1.6 Installation Check (chapter 36). 
See Also: Function 0Ch 


Table 8-1. Format of input buffer: 


Offset Size Description 

00h BYTE maximum characters buffer can hold 

Oth BYTE (input) number of chars from last input which may be recalled 
(return) number of characters actually read, excluding CR 

02h NBYTEs actual characters read, including the final carriage return 

INTERRUPT 21h - Function 0Bh 

GET STDIN STATUS 

Purpose: Determine whether a keystroke is available for input from STDIN. 

Available on: All versions of DOS. Restrictions: none. 

Registers at call: Return Registers: 

AH = 0Bh AL = 00h if no character available 


= FFh if character is available 
Details: Control-C and Control-Break are checked, and INT 23h is called if either was pressed. 
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If the interim console flag is set (see Function 63h Subfunction OIh), this function returns AL=FFh if a partially- 
formed double-byte character is available. 
Conflicts: "G" Virus (chapter 34). 
See Also: Function 06h for input, Function 44h Subfunction 06h 


INTERRUPT 21h - Function 0Ch 
FLUSH BUFFER AND READ STANDARD INPUT 


Purpose: Discard all keystrokes in the typeahead buffer, then perform keyboard input action as specified. 


Available on: All versions of DOS. Restrictions: none. 
Registers at call: Return Registers: 
AH =0Ch as appropriate for the specified input function 


AL = function to execute after flushing buffer 

other registers as appropriate for the input function : 

Details: If AL is not one of O1h, 06h, 07h, O8h, or OAh, the buffer is flushed but no input is attempted. 
Conflicts: None known. 

See Also: Function 06h for input, Functions 01h, 07h, 08h, and OAh 


INTERRUPT 21h ~ Function 0Dh 

DISK RESET 

Purpose: Write all modified disk buffers to disk immediately. 

Available on: All versions of DOS, Restrictions: none, 

Registers at call: Return Registers: n/a 

AH=0Dh 

Details: This function does not update directory information (that is only done when files are closed or a SYNC call 
is issued). 

Conflicts; None known. 

See Also: Function 5Dh Subfunction 01h, INT 13h Function 00h (chapter 6), INT 2Fh Function 1h Subfunction 
20h (chapter 19) 


INTERRUPT 21h - Function 0Eh 


SELECT DEFAULT DRIVE 

Purpose: Log onto specified drive and retumm the number of available drives. 

Ayailable on: All versions of DOS. Restrictions: none. 

Registers at call: Return Registers: 

AH = 0Eh AL = number of potentially valid drive letters 


AL = new default drive 

00h = A:, O1h = B;, etc. 
Details: Under Novell NetWare, the return value is always 32, the number of drives that NetWare supports. Under 
DOS 3+, the return value is the greatest of 5, the value of LASTDRIVES in CONFIG.SYS, and the number of drives 
actually present. On a DOS 1.x/2.x single-floppy system, AL returns 2 since the floppy may be accessed as either A: 
or B:, Otherwise, the return value is the highest drive actually present. 

DOS 1.x supports a maximum of 16 drives, 2.x a maximum of 63 drives, and 3+ a maximum of 26 drives. 
Conflicts: None known. 
See Also: Functions 19h and 3Bh, NetWare Function DBh (chapter 20) 


INTERRUPT 21h - Function OFh 


OPEN FILE USING FCB 

Purpose: Make file available for access using the original FCB method (now obsolete). 
Available on: All versions of DOS. Restrictions: none. 
Registers at call: Return Registers: 

AH = OFh AL = status: 

DS:DX -> unopened File Control Block (Table 8-2) 00h successful 


FFh file not found or access denied 
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Details: DOS 3.1+ opens the file for read/write in compatibility mode. 
An unopened FCB has the drive, filename, and extension fields filled in and all other bytes cleared. 
This call is not supported by the MS Windows 3.0 DOSX.EXE DOS extender, 

Conflicts: None known. 

See Also: Functions 10h, 16h, and 3Dh 


Table 8-2. Format of File Control Block: 


Offset Size Description 

7 BYTE extended FCB if FFh 

~6 SBYTEs reserved 

-1 BYTE file attribute if extended FCB 

00h BYTE drive number (0 = default, 1 = A, etc) 

Olh 8 BYTEs _ blank-padded file name 

09h 3BYTEs _ blank-padded file extension 

0Ch WORD current block number 

OEh WORD logical record size 

10h DWORD file size 

14h WORD date of last write (see Function 57h Subfunction 00h) 

16h WORD (DOS 1.1+) time of last write (see Function 57h Subfunction 00h) 
18h 8BYTEs reserved (Tables 8-3 thru 8-6) 

20h BYTE record within current block 

21h DWORD random access record number (if record size is > 64 bytes, high byte is omitted) 


Note: To use an extended FCB, you must specify the address of the FFh flag at offset -7, rather than the address 
of the drive number field, 


Table 8-3. Format of reserved field for DOS 1.0: 


Offset Size Description 

16h WORD location in directory (if high byte = FFh, low byte is device ID) 
18h WORD number of first cluster in file 

1Ah WORD last cluster number accessed (absolute) 

1Ch WORD relative current cluster number 

1Eh BYTE dirty flag (00h = not dirty) 

1Fh BYTE unused 


Table 8-4, Format of reserved field for DOS 1.10-1.25: 


Offset Size Description 
18h BYTE bit 7: set if logical device 
bit 6: not dirty 
bits 5-0: disk number or logical device ID 


19h WORD starting cluster number 
Bh WORD absolute current cluster number 
1Dh WORD relative current cluster number 
Fh BYTE unused 


Table 8-5. Format of reserved field for DOS 2.x: 


Offset Size Description 

8h BYTE bit 7: set if logical device 
bit 6: set if open 
bits 5-0: unknown. 





9h WORD starting cluster number 
Bh WORD unknown. 

1Dh BYTE unknown, 
Eh BYTE unknown, 


1Fh BYTE unknown, 
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Table 8-6, Format of reserved field for DOS 3.x: 


Offset Size Description 
18h BYTE number of system file table entry for file 
19h BYTE attributes: 


bits 7,6: 00 = SHARE.EXE not loaded, disk file 
01 = SHARE.EXE not loaded, character device 
10 = SHARE.EXE loaded, remote file 
11 = SHARE.EXE loaded, local file 

bits 5-0: low six bits of device attribute word 


--SHARE.EXE loaded, local tile 











1A WORD starting cluster of file 

1c. WORD offset within SHARE of sharing record (see Function 52h) 
1Eh BYTE file attribute 

1Fh BYTE unknown. 
--SHARE.EXE loaded, remote file 

1Ah WORD number of sector containing directory entry 

1Ch WORD relative cluster within file of last cluster accessed 

1Eh BYTE absolute cluster number of last cluster accessed 

1Fh BYTE unknown, 
-~SHARE.EXE not loaded 

1Al BYTE (low byte of device attribute word AND 0Ch) OR open mode 
1B. WORD starting cluster of file 

1DI WORD number of sector containing directory entry 

1Fh BYTE number of directory entry within sector 


Note: If an FCB is opened on a character device, the dword at 1Ah is set to the address of the device driver 
header, then the byte at 1 Ah is overwritten. 


INTERRUPT 21h - Function 10h 


CLOSE FILE USING FCB 

Purpose: Flush all buffers for file to disk and update directory information (obsolete method). 
Available on: All versions of DOS. Restrictions: none. 

Registers at call: Return Registers: 

AH = 10h AL = status: 

DS:DX -> File Control Block (see Table 8-2) 00h successful 


FFh failed 
Details: A successful close forces all disk buffers used by the file to be written and the directory entry to be updated. 
This call ig not supported by the MS Windows 3.0 DOSX.EXE DOS extender. 
Conflicts: None known. 
See Also: Functions OFh, 16h, and 3Eh 


INTERRUPT 21h - Function 11h 
FIND FIRST MATCHING FILE USING FCB 


Purpose: Locate first file in current directory that matches FCB (now obsolete). 


Available on: All versions of DOS. Restrictions: none. 
Registers at call: Return Registers: 
AH = 11h AL = status: 
DS:DX -> unopened FCB (see Table 8-2), may 00h successful 
contain '?' wildcards [DTA] = unopened FCB for first matching file 


FFh no matching filename, or bad FCB 
Details: DOS 3+ also allows the '*' wildcard. 
The type of the returned FCB depends on whether the input FCB was a normal or an extended FCB. The search 
FCB must not be modified if Function 12h will be used to continue searching; DOS 3.3 has set the following parts of 
the FCB: 


i 
i 
| 
i 
' 
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Table 8-7. Values set into FCB by DOS 3.3: 


Offset Size Description 

0Ch BYTE unknown. 

ODh WORD directory entry number of matching file 
OFh WORD cluster number of current directory 

Tlh 4BYTEs unknown. 

15h BYTE drive number (1=A:) 


Note: At least for DOS 3.3, the unopened FCB in the DTA is actually the drive number followed by the file's 
directory entry. 
Conflicts: None known. 
See Also: Functions 12h, 1Ah, and 4Eh, INT 2Fh Function 11h Subfunction 1Bh (chapter 19) 


INTERRUPT 21h - Function 12h 
FIND NEXT MATCHING FILE USING FCB 


Purpose: Locate next file that matches FCB (now obsolete). 
Available on: All versions of DOS. Restrictions: Function 11h must have been called 
previously. 
Registers at call: 
AH = 12h 
DS:DX -> unopened FCB (Table 8-2) 
Return Registers: 
AL = status: 
00h successful 
[DTA] = unopened FCB 
FFh no more matching filenames 
Details: Assumes that a successful FindFirst (see Function I 1h) was executed on the search FCB before the call. 
Conflicts: None known, 
See Also: Functions 1Ah and 4Fh, INT 2Fh Function 11h Subfunction 1Ch (chapter 19) 


INTERRUPT 21h - Function 13h 


DELETE FILE USING FCB 

Purpose: Delete all files that match FCB (now obsolete). 

Available on: All versions of DOS. Restrictions: none. | 

Registers at call: Return Registers: i 

AH = 13h AL = status: : 

DS:DX -> unopened FCB (see Table 8-2) 00h one or more files successfully deleted : 
filename filled with template for deletion FFh no matching files or all were read-only or 1 
('7' wildcards allowed) locked 


of the attribute set (bits 1 and 2 for DOS 1). This may have originally been an optimization to minimize directory 
searching after a mass deletion, but can corrupt the filesystem under DOS 2+ because subdirectories are removed 
without deleting the files they contain. 

Currently-open files should not be deleted. 
Conflicts: None known. 
See Also: Function 41h, INT 2Fh Function 11h Subfunction 13h (chapter 19) 


INTERRUPT 21h - Function 14h 
SEQUENTIAL READ FROM FCB FILE 


Purpose: Read one record (usually 128 bytes) from the specified FCB-opened file into the Disk Transfer Area. 
Available on: All versions of DOS. Restrictions: none. 





Registers at call: 
AH = 14h 
DS:DX -> opened FCB (see Table 8-2) 
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Return Registers: 
AL = status: 

00h successful 

Oth end of file (no data) 

02h segment wrap in DTA 

03h end of file, partial record read 
{DTA] = record read from file 


Details: Reads a record of the size specified in the FCB beginning at the current file position, then updates the 
current block and current record fields in the FCB. If a partial record was read, it is zero-padded to the full size. 
This call is not supported by the MS Windows 3.0 DOSX.EXE DOS extender, 


Conflicts: None known. 


See Also: Functions OFh, 15h, 1Ah, and 3Fh, INT 2Fh Function 11h Subfunction 08h (chapter 19) 


INTERRUPT 21h - Function 15h 
SEQUENTIAL WRITE TO FCB FILE 


Purpose: Write one record (usually 128 bytes) to the specifie: 


Available on: All versions of DOS. 
Registers at call: 

AH = iSh 

DS:DX -> opened FCB (see Table 8-2) 
[DTA] = record to write 


Details: Writes a record of the size specified in the FCB 
current block and current record fields in the FCB. If less tl 


DOS buffer to be written out at a later time. 


d FCB-opened file from the Disk Transfer Area. 
Restrictions: none. 
Return Registers: 
AL = status: 
00h successful 
O1h disk full 
02h segment wrap in DTA 


beginning at the current file position, then updates the 
han a full disk sector is written, the data is placed in a 


This call is not supported by the MS Windows 3,0 DOSX.EXE DOS extender. 


Conflicts: None known. 


See Also: Functions OFh, 14h, 1Ah, and 40h, INT 2Fh Function 11h Subfunction 09h (chapter 19) 


INTERRUPT 21h - Function 16h 
CREATE OR TRUNCATE FILE USING FCB 


Purpose: Create empty file using FCB (now obsolete). 
Available on: All versions of DOS. 
Registers at call: 
AH = 6h 
DS:DX -> unopened FCB (see Table 8-2), 
wildcards not allowed 


Restrictions: none. 
Return Registers: 
AL = status: 
00h successful 
FFh directory full or file exists and is read-only or 
locked 


Details: If the file already exists, it is truncated to zero length. If an extended FCB is used, the file is given the 


attribute in the FCB. 


This call is not supported by the MS Windows 3.0 DOSX.EXE DOS extender. 


Conflicts: None known. 
See Also: Functions OFh, 10h, and 3Ch 


INTERRUPT 21h - Function 17h 
RENAME FILE USING FCB 


Purpose: Change name of file using FCB {now obsolete). 


Available on; All versions of DOS. 


Restrictions: none. 
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Registers at call: Return Registers: 

AH = 17h AL = status: 

DS:DX -> modified FCB (see Table 8-2). The old 00h successfully renamed 
filename ('?' wildcards OK) is in the FFh no matching files, file is read-only, or new 
standard location, while the new filename name already exists 


(?' wildcards OK) is stored in the 11 bytes 

beginning at offset 11h 
Details: Subdirectories may be renamed using an extended FCB with the appropriate attribute. 
Conflicts: None known. 
See Also: Functions OFh, 13h, and 56h, INT 2Fh Function 11h Subfunction 11h (chapter 19) 


INTERRUPT 21h - Function 18h 


NULL FUNCTION FOR CP/M COMPATIBILITY 


Purpose: This function does nothing; it corresponds to a CP/M BDOS function which is meaningless under 
MSDOS. 


Available on: All versions of DOS. Restrictions: none. 
Registers at call: Return Registers: 
AH = 18h AL = 00h 


Conflicts: None known, 
See Also: Functions [Dh, 1Eh, and 20h 


INTERRUPT 21h - Function 19h 
GET CURRENT DEFAULT DRIVE 


Purpose: Determine number of "current" drive, 


Available on: All versions of DOS, Restrictions: none. 
Registers at call: Return Registers: 
AH = 19h AL = drive (00h = A:, 01h = B:, etc) 


Conflicts: None known. 
See Also: Functions OEh and 47h 


INTERRUPT 21h - Function 1Ah 
SET DISK TRANSFER AREA ADDRESS 


Purpose: Establish address of buffer to use for disk 1/O and directory searches, 


Available on: All versions of DOS. Restrictions: none. 
Registers at call: Return Registers: n/a 
AH=IAh 


DS:DX -> Disk Transfer Area (DTA) 

Details: The DTA is set to PSP:0080h when a program is started. 
Conflicts: None known. 

See Also: Functions I 1h, 12h, 2Fh, 4Eh, and 4Fh 


INTERRUPT 21h - Function 1Bh 
GET ALLOCATION INFORMATION FOR DEFAULT DRIVE 


Purpose: Determine size of current default drive, 


Available on: All versions of DOS. Restrictions: none. 
Registers at call: Return Registers: 
AH = 1Bh AL = sectors per cluster (allocation unit) 


CX = bytes per sector 

DX = total number of clusters 

DS:BX -> media ID byte (Table 8-8) 
Details: Under DOS 1.x, DS:BX points at an actual copy of the first FAT sector; later versions return a pointer to a 
copy of the FAT's ID byte. 
Conflicts: None known, 
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See Also: Functions 1Ch and 36h 


Tabie 8-8. Values for LD byte (not always accurate): 


Byte Media Description i 
FFh floppy double-sided, 8 sectors per track (320K) | 
FEh floppy single-sided, 8 sectors per track (160K) | 
FDh floppy double-sided, 9 sectors per track (360K) 

FCh floppy single-sided, 9 sectors per track (180K) 

F9h floppy double-sided, 15 sectors per track (1.2M) | 
F8h hard disk ' 
FOh other i 


INTERRUPT 21h - Function 1Ch 
GET ALLOCATION INFORMATION FOR SPECIFIC DRIVE 


Purpose: Determine size of specified drive. i 
Available on: All versions of DOS. Restrictions: none. | 
Registers at call: i 
AH = !Ch 
DL = drive (00h = default, Oh = A:, etc) 

Return Registers: 

AL = sectors per cluster (allocation unit) 

CX = bytes per sector 

DX = total number of clusters 

DS:BX -> media ID byte (see Function 1Bh) 
Details: Under DOS 1.x, DS:BX points at an actual copy of the first FAT sector; later versions return a pointer to a 
copy of the FAT's ID byte. 
Conflicts: None known. 
See Also: Functions 1Bh and 36h 


INTERRUPT 21h - Function 1Dh | 
NULL FUNCTION FOR CP/M COMPATIBILITY 





Purpose: This function does nothing; it corresponds to a CP/M BDOS funetion which is meaningless under 
MSDOS. 

Available on: All versions of DOS. Restrictions: none. 

Registers at call: Return Registers: 

AH = 1Dh AL = 00h 

Conflicts: None known, 

See Also: Functions 18h, 1Eh, and 20h 


INTERRUPT 21h - Function 1Eh 
NULL FUNCTION FOR CP/M COMPATIBILITY 


Purpose: This function does nothing; it corresponds to a CP/M BDOS function which is meaningless under | 
MSDOS. | 


Available on: All versions of DOS. Restrictions: none, | 
Registers at call: Return Registers: | 
AH = !Eh AL = 00h 


Conflicts: None known. | 
See Also: Function 18h, Function 1Dh, Function 20h | 


INTERRUPT 21h - Function 1Fh 


GET DRIVE PARAMETER BLOCK FOR DEFAULT DRIVE 


Purpose: Obtain details of disk parameters for the current drive. 
Available on: All versions of DOS. Restrictions: none. 
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Registers at call: Return Registers: 
AH=IFh AL = status: 
00h successful 
DS:BX -> Drive Parameter Block (DPB) 
(see Table 8-9 for DOS 1.x, 
Function 32h for DOS 2+) 
FFh invalid drive 
Details: This function has been newly documented for DOS 5.0; it was undocumented in prior versions, 
Conflicts: None known, 
See Also: Function 32h 


Table 8-9. Format of DOS 1.1 and MSDOS 1.25 drive Parameter block: 





Offset Size Description 

00! BYTE entry number 

Oth BYTE physical drive number 

02! WORD bytes per sector 

04h BYTE highest sector number within a cluster 
05) BYTE shift count to convert clusters to sectors 
06h WORD starting sector number of first FAT 

08) BYTE number of copies of FAT 

09h WORD number of directory entries 

OBh WORD number of first data sector 

ODh WORD highest cluster number (number of data clusters + 1) 
OFh BYTE sectors per FAT 

10h WORD starting sector of (root) directory 

12h WORD address of allocation table 


Note: The DOS 1.0 parameter block is the same except that it omits the first and last fields. 
INTERRUPT 21h - Function 20h 
NULL FUNCTION FOR CP/M COMPATIBILITY 


Purpose: This function does nothing; it corresponds to a CP/M BDOS function which is meaningless under 
MSDOS. 


Available on; All versions of DOS. Restrictions: none. 
Registers at call: Return Registers: 
AH = 20h AL = 00h 


Conflicts: None known, 
See Also: Functions 18h, 1Dh, and 1Eh 


INTERRUPT 2th - Function 21h 
READ RANDOM RECORD FROM FCB FILE 


Purpose: Read specified record from file using FCB (now obsolete). 


Available on: All versions of DOS, Restrictions: none. 
Registers at call: Return Registers: 
AH = 21h AL = status: 
DS:DX -> opened FCB (see Table 8-2) 00h successful 


O1h end of file, no data read 

02h segment wrap in DTA, no data read 

03h end of file, partial record read 

{[DTA] = record read from file 
Details: The record is read from the current file position as specified by the random record and record size fields of 
the FCB. The file position is not updated after reading the record. If a partial record is read, it is zero-padded to the 
full size. 
This cail is not supported by the MS Windows 3.0 DOSX.EXE DOS extender. 

Conflicts: None known. 
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See Also: Functions 14h, 22h, 27h, and 3Fh 


INTERRUPT 21h - Function 22h 
WRITE RANDOM RECORD TO FCB FILE 


Purpose: Write specified record to file using FCB (now obsolete). 


Available on: All versions of DOS. Restrictions: none. 
Registers at call: Return Registers: 
AH = 22h AL = status: 
DS:DX -> opened FCB (sce Table 8-2) OOh successful 
[DTA] = record to write Oth disk full 


02h segment wrap in DTA 
Details: The record is written to the current file position as specified by the random record and record size fields of 
the FCB. The file position is not updated after writing the record. 

If the record is located beyond the end of the file, the file is extended but the intervening data remains 
uninitialized. If the record only partially fills a disk sector, it is copied to a DOS disk buffer to be written out to disk 
at a later time. 

This call is not supported by the MS Windows 3.0 DOSX.EXE DOS extender. 

Conflicts: None known. 
See Also: Functions 15h, 21h, 28h, and 40h 


INTERRUPT 21h - Function 23h 





GET FILE SIZE FOR FCB 

Purpose: Get size of file into its FCB (now obsolete). 

Available on: All versions of DOS. Restrictions: none. 

Registers at call: Return Registers: 

AH = 23h AL = status: 

DS:DX -> unopened FCB (see Function OFh), 00h successful (matching file found) FCB random 
wildcards not allowed record field filled with size in records, 


rounded up to the next full record 
FEh failed (no matching file found) 
Details: This call is not supported by the MS Windows 3.0 DOSX.EXE DOS extender. 
Conflicts: None known. 
See Also: Function 42h 


INTERRUPT 21h - Function 24h 
SET RANDOM RECORD NUMBER FOR FCB 


Purpose: Specify record to be read/written by Functions 21h/22h. 


Available on: All versions of DOS. Restrictions: none. 
Registers at call: Return Registers: n/a 
AH = 24h 


DS:DX -> opened FCB (sce Function OFh) 
Details; Computes the random record number corresponding to the current record number and record size, then 
stores the result in the FCB. Normally used when switching from sequential to random access, 
This call is not supported by the MS Windows 3.0 DOSX.EXE DOS extender. 
Conflicts: None known. 
See Also: Functions 21h, 27h, and 42h 


INTERRUPT 21h - Function 25h 

SET INTERRUPT VECTOR 

Purpose: Modify address of routine to service specified interrupt. 

Available on: All versions of DOS. Restrictions: none. 
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Registers at call: Return Registers: n/a 
AH = 25h 

AL = interrupt number 

DS:DX -> new interrupt handler 

Details: This function is preferred over direct modification of the interrupt vector table. 
Conflicts: Phar Lap 386/DOS-Extender (chapter 9), 

See Also: Function 35h 


INTERRUPT 21h - Function 26h 
CREATE NEW PROGRAM SEGMENT PREFIX 


Purpose: Create Program Segment Prefix (PSP); now obsolete, as the same action is performed as part of Function 
4Bh. 


Available on: All versions of DOS, Restrictions: none. 
Registers at call: Return Registers: n/a 
AH = 26h 


DX = segment at which to create PSP (Table 8-10) 
Details: The new PSP is updated with memory size information; INTs 22h, 23h, 24h are taken from interrupt vector 
table. DOS 2+ assumes that the caller's CS is the segment of the PSP to copy. 

In DOS versions 3.0 and up, the limit on simultaneously open files may be increased by allocating memory for a 
new open file table, filling it with FFh, copying the first 20 bytes from the default table, and adjusting the pointer and 


use values of 80h-FEh in the open file table to indicate remote files, 
Conflicts: None known. 
See Also: Functions 4Bh, 50h, 51h, 55h, 62h, and 67h 


Table 8-10. Format of PSP: 


Offset Size Description 
00h 2BYTEs INT 20h instruction for CP/M CALL 0 program termination 
02h WORD segment of first byte beyond memory allocated to program 
04h BYTE unused filler 
05h BYTE CP/M CALL 5 service request (FAR JMP to 000COh) 
BUG: (DOS 2+) PSPs created by INT 21h Function 4Bh point at OOOBEh 
06h WORD CP/M compatibility--size of first segment for .COM files 
08h 2BYTEs remainder of FAR JMP at 05h 
OAh DWORD - stored INT 22h termination address 
OEh DWORD stored INT 23h control-Break handler address 
12h DWORD _ stored INT 24h critical error handler address (DOS 11+) 
16h WORD segment of parent PSP 
18h 20BYTEs DOS 2+ Job File Table, one byte per file handle, FFh = closed 
2Ch WORD DOS 2+ segment of environment block (Table 8-11) for process 
2Eh DWORD DOS 2+ process's SS:SP on entry to last INT 21h call 
32h WORD DOS 3+ number of entries in JFT (default 20) 
34h DWORD DOS 3+ pointer to JFT (default PSP:0018h) 
38h DWORD DOS 3+- pointer to previous PSP (default FEFFFFFFh in 3.x) used by SHARE in DOS 3.3 
3Ch 4BYTEs unused by DOS versions <= 5.00 
40h 2BYTEs DOS 5.0 version to return on INT 21h Function 30h 
42h 14BYTEs unused by DOS versions <= 5.00 
50h 3BYTEs DOS 2+ service request (INT 21h/RETEF instructions) 
53h 9BYTEs unused in DOS versions <= 5,00 
SsCh 16 BYTEs first default FCB, filled in from first commandline argument 
overwrites second FCB if opened 
6Ch 16 BYTEs second default FCB, filled in from second commandline argument 


overwrites beginning of commandline if opened 
7Ch 4BYTEs unused 
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Table 8-10. Format of PSP (continued) 


Offset Size Description 
80h 128 BYTEs commandline / default DTA. Command tail is BYTE for length of tail, N BYTEs for the 
tail, followed by a BYTE containing ODh 


Table 8-11. Format of environment block: 


Offset Size Description 
00h NBYTEs _ first environment variable, ASCIZ string of form "var=value" 
NBYTEs second environment variable, ASCIZ string 


N BYTEs last environment variable, ASCIZ string of form "yvar=value" 
BYTE 00h 


DOS 3+ 
WORD number of strings following environment (normally i) 
NBYTEs ASCIZ pathname of program owning this environment; other strings may follow 


INTERRUPT 21h - Function 27h 
RANDOM BLOCK READ FROM FCB FILE 


Purpose: Read multiple records from FCB (obsolete), starting with specified record, 


Available on: All versions of DOS. Restrictions: none. 

Registers at call: Return Registers: 

AH = 27h AL = status: 

CX = number of records to read 00h successful, all records read 
DS:DX -> opened FCB (see Table 8-2) Olh end of file, no data read 


02h segment wrap in DTA, no data read 
03h end of file, partial read 

[DTA] = records read from file 

CX = number of records read (status 00h or 03h) 
Details: The read begins at the current file position as specified in FCB; the file position is updated after reading. 

This call is not supported by the MS Windows 3.0 DOSX.EXE DOS extender. 

Conflicts: None known. 
See Also: Functions 21h, 28h, and 3Fh 


INTERRUPT 21h - Function 28h 
RANDOM BLOCK WRITE TO FCB FILE 


Purpose: Write multiple records from FCB (obsolete), starting with specified record. 


Available on: All versions of DOS. Restrictions: none. 

Registers at call: Return Registers: 

AH = 28h AL = status: 

CX = number of records to write 00h successful 

DS:DX -> opened FCB (see Table 8-2) Oth disk full or file read-only 
{DTA] = records to write 02h segment wrap in DTA 


CX = number of records written 

Details: The write begins at the current file position as specified in FCB; the file position is updated after writing. If 
CX = 0000h on entry, no data is written; instead the file size is adjusted to be the same as the file position specified 
by the random record and record size fields of the FCB. If the data to be written is less than a disk sector, it is copied 
into a DOS disk buffer, to be written out to disk at a later time. 

This call is not supported by the MS Windows 3.0 DOSX.EXE DOS extender. 
Conflicts: None known. 
See Also: Functions 22h, 27h, 40h, and 59h 
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INTERRUPT 21h - Function 29h 
PARSE FILENAME INTO FCB 


Purpose: Analyze a filename and copy the appropriate portions into an FCB; obsolete except when using obsolete 
FCB calls or spawning a child program. 


Available on: All versions of DOS. Restrictions: none. 
Registers at call: Return Registers: 
AH = 29h AL = resuit code: 
AL = parsing options: 00h successful parse, no wildcards encountered 
bit 0: skip leading separators Oth successful parse, wildcards present 
bit 1: use existing drive number in FCB if FFh invalid drive specifier 
no drive is specified, instead of DS:SI -> first unparsed character 
setting field to zero ES:DI buffer filled with unopened FCB 
bit 2: use existing filename in FCB if no (see Table 8-2) 


base name is specified, instead of 
filling field with blanks 
bit 3: use existing extension in FCB if no 
extension is specified, instead of 
filling field with blanks 
bits 4-7; reserved (0) 
DS:SI -> filename string (both ™' and '?' wildcards 
OK) 
ES:DI -> buffer for unopened FCB 
Details: Asterisks are expanded to question marks in the FCB. All processing stops when a filename terminator is 
encountered. Cannot be used with filespecs which include a path (DOS 2+). Can be used to determine whether a 
specified drive exists, without generating a DOS critical error if it does not. 
Conflicts: None known, 
See Also: Functions OFh, 16h, and 26h 


INTERRUPT 2th - Function 2Ah 


GET SYSTEM DATE 
Purpose: Read date from system internal calendar. 
Available on: All versions of DOS. Restrictions: none. 
Registers at call: Return Registers: 
AH = 2Ah CX = year (1980-2099) 
DH = month 
DL = day 


AL = (DOS 1.10+) day of week (00h=Sunday) 
Conflicts: None known. 
See Also: Functions 2Bh-2Dh, NetWare Function 7h (chapter 20), INT 1Ah Function 04h (chapter 3) 


INTERRUPT 21h - Function 2Bh 


SET SYSTEM DATE 

Purpose: Change date as shown on system internal calendar. 

Available on: All versions of DOS. Restrictions: none. 

Registers at call: Return Registers: 

AH =2Bh AL = status: 

CX = year (1980-2099) 00h successful 

DH = month FFh invalid date, system date unchanged 
DL= day 


Details: DOS 3.3+ also sets the CMOS real-time clock. 
Conflicts: PC Tools v5.1 PC-CACHE (chapter 6), DESQview Installation Check (chapter 15), ppANYWHERE IV 
(chapter 28), ELRES v1.1 (chapter 36), TAME (chapter 36). 
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See Also: Functions 2Ah and 2Dh, INT [Ah Function 05h (chapter 3) 
INTERRUPT 21h - Function 2Ch 


GET SYSTEM TIME 
Purpose: Read time as shown on system internal clock. 
Available on: All versions of DOS. Restrictions: none. 
Registers at call: Return Registers: 
AH =2Ch CH = hour 

CL = minute 

DH = second 


DL = 1/100 seconds 
Details: On most systems, the resolution of the system clock is about 5/100sec, so returned times generally do not 
increment by 1. On some systems, DL may always return 00h. 
Conflicts: None known. 
See Also: Functions 2Ah and 2Dh, NetWare Function E7h (chapter 20), INT LAh Functions 00h and 02h (chapter 3), 
INT 1Ah Function FEh (chapter 4) 


INTERRUPT 21h - Function 2Dh 


SET SYSTEM TIME 

Purpose: Change time as shown on system internal clock, 

Available on: All versions of DOS. Restrictions: none. 

Registers at call: Return Registers: 

AH =2Dh AL = result: 

CH = hour 00h successful 

CL = minute FFh invalid time, system time unchanged 
DH = second 


DL = 1/100 seconds 

Details: DOS 3.3+ also sets the CMOS real-time clock. 

Conflicts: None known, 

See Also: Functions 2Ah-2Ch, INT 1Ah Functions 01h and 03h (chapter 3), INT 1Ah Function FFh (chapter 4) 


INTERRUPT 21h - Function 2Eh 


SET VERIFY FLAG 

Purpose: Control the state of the disk-write verification flag. 

Available on: All versions of DOS. Restrictions: none. 
Registers at call: Return Registers: n/a 
AH = 2Eh 


DL = 00h (DOS 1.x/2.x only) 
AL = 00h verify flag off 
Oh verify flag on 
Details: The default state at system boot is OFF, When ON, all disk writes are verified provided the device driver 
supports read-after-write verification. Many drivers, including those supplied with MS-DOS, only perform CRC 
checking as "verification”. 
Conflicts: None known. 
See Also: Function 54h 


INTERRUPT 21h - Function 2Fh 
GET DISK TRANSFER AREA ADDRESS 


Purpose: Determine the address of the current disk I/O buffer. 


Available on: DOS 2.0 or higher. Restrictions: none. 
Registers at call: Return Registers: 
AH = 2Fh ES:BX -> current DTA 


Conflicts: None known, 
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See Also: Function 1Ah 


INTERRUPT 21h - Function 30h 
GET DOS VERSION 


Purpose: Determine which version of MS-DOS is in use. 


Available on: DOS 2.0 or higher. 
Registers at call: 
AH = 30h 
AL = what to return in BH (DOS 5+ only) 
00h OEM number 
O1h version flag 


Restrictions: none. 
Return Registers: 
AL = major version number (00h if DOS 1.x) 
AH = minor version number 
BL:CX = 24-bit user serial number (most versions do 
not use this) 
BH = OEM number: 
O0hIBM 
16hDEC 
99hSTARLITE architecture (OEM DOS, 
NETWORK DOS, SMP DOS) 
FFh — Phoenix 
BH = version flag (DOS 5.0 only): 
08h DOS is in ROM 
10h DOS is in HMA 


Details: The OS/2 v1.x Compatibility Box returns major version OAh, while the OS/2 v2.x Compatibility Box 


returns major version 14h. DOS 4.01 and 4.02 identify themselves as version 4.00, 
The version returned under DOS 4,0x may be modified by entries in the special program list (see AH=52h). The 
version returned under DOS 5+ may be modified by SETVER; use Function 33h Subfunction 06h to get the true 


version number. 


Conflicts: Phar Lap 386/DOS-Extender (chapter 9), CTask 2.0+ (chapter 17), "Dutch-555" virus (chapter 34). 
See Also: Function 33h Subfunction 06h, INT 2Fh Function 12h Subfunction 2Fh 


INTERRUPT 21h - Function 31h 
TERMINATE AND STAY RESIDENT 


Purpose: Terminate process without releasing resources allocated to it; these resources include environment space, 


memory, and file handles, 

Available on: DOS 2.0 or higher. 

Registers at call: 

AH = 3th 

AL = return code 

DX = number of paragraphs to keep resident 


Restrictions: none. 
Return Registers: 
never returns 


Details: The value in DX only affects the memory block containing the PSP; additional memory allocated via 
Function 48h is not affected. Most TSRs can save some memory by releasing their environment block before 


terminating (see Functions 26h and 49h). 
Conflicts: None known. 


See Also: Functions 00h, 4Ch, and 4Dh, INT 20h, INT 22h, INT 27h 


INTERRUPT 2th - Function 32h 


GET DOS DRIVE PARAMETER BLOCK FOR SPECIFIC DRIVE 


Purpose: Obtain details of disk parameters for specified drive, 


Available on: DOS 2.0 or higher. 

Registers at call: 

AH = 32h 

DL = drive number (00h = default, 01h = A:, etc) 


Restrictions: none. 
Return Registers: 
AL = status: 
00h successful 
DS:BX -> Drive Parameter Block (DPB) for 
specified drive (Table 8-12) 
FFh invalid drive 


Details: The OS/2 compatibility b 
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This function has been newly documented for DOS 5.0; it was undocumented in prior versions. 


Conflicts: None known. 


See Also: Function Fh 


Table 8-12, Format of DOS Drive Parameter Block: 





Offset Size Description 
00h BYTE drive number (00h = A:, 01h = B:, etc) 
ol BYTE unit number within device driver 
02h WORD bytes per sector 
041 BYTE highest sector number within a cluster 
OSh BYTE shift count to convert clusters into sectors 
06h WORD number of reserved sectors at beginning of drive 
08h BYTE number of FATs 
09h WORD number of root directory entries 
OBh WORD number of first sector containing user data 
ODh WORD highest cluster number (number of data clusters + 1) 
DOS 2.x-3.X 
OFh BYTE number of sectors per FAT 
10h WORD sector number of first directory sector 
12h DWORD address of device driver header 
16h BYTE media ID byte 
17h BYTE 00h if disk accessed, FFh if not 
18h DWORD _ pointer to next DPB 
---DOS 2.x 
1Ch WORD cluster containing start of current directory, 0000h=root, FFFFh = not known 
1Eh 64BYTEs ASCIZ pathname of current directory for drive 
--DOS 3.x 
1Ch WORD cluster at which to start search for free space when writing 
1Eh WORD number of free clusters on drive, FFFFh = not known 
--DOS 4.0-5.0 
OFh WORD number of sectors per FAT 
{1h WORD sector number of first directory sector 
13h DWORD address of device driver header 
17h BYTE media ID byte 
18h BYTE 00h if disk accessed, FFh if not 
19h DWORD _ pointer to next DPB 
iDh WORD cluster at which to start search for free space when writing 
1Fh WORD number of free clusters on drive, FFFFh = not known 


INTERRUPT 21h - Function 33h, Subfunctions 00h and 01h 

EXTENDED BREAK CHECKING 

Purpose: Determine the state of the control-BREAK check flag. 

Available on: DOS 2.0 or higher. Restrictions: none. 
Registers at call: 


AH = 33h 


AL = 00h get current extended break state 


Return Registers: 
DL = current state, 00h = off, 01h = on 


Break checking: 


ox supports the DOS 3.3 version of this call except for the DWORD at offset 12h, 


AL = Oth set state of extended Contro!-C and Control- 


DL = 00h off, check only on character Y/O functions 
01h on, check on all DOS functions 
Details: Under DOS 3.14, this function does not use any of the DOS-internal stacks and is thus fully reentrant. 
Conflicts: None known. 
See Also: Function 33h Subfunction 02h 
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INTERRUPT 21h - Function 33h, Subfunction 02h 
GET AND SET EXTENDED CONTROL-BREAK CHECKING STATE 


Purpose: Determine and update the state of the control-BREAK flag in a single operation. 


Available on: DOS 3.0 or higher. Restrictions: This call is not documented and 
therefore subject to change. 

Registers at call: Return Registers: 

AX = 3302h DL = old state of extended BREAK checking 


DL= 00h checking OFF 
Oth checking ON 
Details: This function does not use any of the DOS-internal stacks and is thus fully reentrant. 
Conflicts: None known. 
See Also: Function 33h Subfunction 01h 


INTERRUPT 2th - Function 33h, Subfunction 05h 


GET BOOT DRIVE 

Purpose: Determine drive from which the system was booted, 

Available on: DOS 4.0 or higher. Restrictions: none. 
Registers at call: Return Registers: 

AX = 3305h DL = boot drive (1=A;....) 


Conflicts: None known. 
INTERRUPT 21h - Function 33h, Subfunction 06h 
GET TRUE VERSION NUMBER 


Purpose: Determine the actual version of MSDOS in use even if SETVER has changed the version that Function 
30h returns, 


Available on: DOS 5.0 or higher. Restrictions: none, 

Registers at call: Return Registers: 

AX = 3306h BL = major version 
BH = minor version 
DL = revision 


DH = version flags 
bit 3: DOS is in ROM 
bit 4: DOS in in HMA 
Conflicts; None known. : 
See Also: Function 30h i 


INTERRUPT 21h - Function 34h 
GET ADDRESS OF INDOS FLAG 


Purpose: Determine the address of the DOS indicator flag. The value of InDOS is incremented whenever an INT 
21h function begins and decremented whenever one completes, 


Available on: DOS 2.0 or higher. Restrictions: none. 
Registers at call: Return Registers: 
AH = 34h ES:BX -> one-byte InDOS flag 


Details: During an INT 28h call, it is safe to call some INT 21h functions even though InDOS may be Oth instead of 
zero. InDOS alone is not sufficient for determining when it is safe to enter DOS, as the critical error handling 
decrements InDOS and increments the critical error flag for the duration of the critical error. Thus, it is possible for 
InDOS to be zero even if DOS is busy. 

The critical error flag is the byte immediately following InDOS in DOS 2.x, and the byte before the nDOS flag 
in DOS 3+ (except COMPAQ DOS 3.0, where the critical error flag is located ! AAh bytes before the critical section 
flag). For DOS 3.1+, an undocumented call exists to get the address of the critical error flag (see Function 5Dh 
Subfunction 06h). 

Conflicts: None known. 
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See Also: Function 5Dh Subfunctions 06h and OBh, INT 28h 
INTERRUPT 21h - Function 35h 


GET INTERRUPT VECTOR 

Purpose: Determine address of service routine for specified interrupt. 

Available on: DOS 2.0 or higher. Restrictions: none. 

Registers at call: Return Registers: 

AH = 35h ES:BX -> current interrupt handler 


AL = interrupt number 
Conflicts: “Agiplan” virus (chapter 34). 
See Also: Function 25h 


INTERRUPT 21h - Function 36h 


GET FREE DISK SPACE 

Purpose: Determine the amount of space available on the specified drive. 

Available on: DOS 2.0 or higher. Restrictions: none. 
Registers at call: Return Registers: 

AH = 36h AX = FFFFh if invalid drive 
DL = drive number (00h = default, O1h = A:, etc) else 


AX = sectors per cluster 

BX = number of free clusters 

CX = bytes per sector 

DX = total clusters on drive 
Details: Free space on drive in bytes is AX * BX * CX; total space on drive in bytes is AX * CX * DX. "Lost 
clusters" are considered to be in use. The value in DX is reportedly incorrect for non-default drives after ASSIGN is 
run on some versions of DOS. 
Conflicts: None known. 
See Also: Functions 1Bh and 1Ch 


INTERRUPT 21h - Function 37h, Subfunction 00h 
"SWITCHAR" - GET SWITCH CHARACTER 


Purpose: Determine whether ‘/ or '-' is used as "switch" indicator in command lines. 


Available on: DOS 2.0 or higher. Restrictions: none. 
Registers at call: Return Registers: 
AX = 3700h AL = status: 

00h successful 


DL = current switch character 
(always '/' in DOS 5) 
FFh unsupported subfunction 
Details; Documented in some OEM versions of some releases of DOS. Supported by OS/2 compatibility box. 
Conflicts: None known. 
See Also: Function 37h Subfunction 01h 


INTERRUPT 21h - Function 37h, Subfunction 01h 
"SWITCHAR" « SET SWITCH CHARACTER 


Purpose: Determines whether ‘/ or '~' is used as “switch” indicator in command lines. Not all DOS utility programs 
pay attention, however. 


Available on: DOS 2.0 or higher. Restrictions: none, 
Registers at call: Return Registers: 

AX = 3701h AL = status: 

DL = new switch character 00h successful 


FFh unsupported subfunction 
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Details: Documented in some OEM versions of some releases of DOS. Supported by OS/2 compatibility box. DOS 5 
returns 00h but does not change character. 

Conflicts; None known. 

See Also: Function 37h Subfunction 00h 


INTERRUPT 21h - Function 37h, Subfunctions 02h and 03h 
“AVAILDEV" - SPECIFY PREFIX USE 


Purpose: Control use of ‘\DEV\" prefix on device names. 


Available on: DOS 2.x and DOS 3.3 or higher Restrictions: none. 
only. 

Registers at call: Return Registers: 

AH = 37h AL = status: 


00h successful 
FFh unsupported subfunction 
AL = subfunction: 
02h get availdev flag DL=00h must precede character device names 
nonzero _ is optional 
O3h set availdev flag 
DL =00h_ is mandatory 
nonzero is optional 
Details: All versions of DOS from 2.00 allow "\DEV\" to be prepended to device names without generating an error 
even if the directory does not actually exist (other paths generate an error if they do not exist). Although DOS 3.3+ 
accepts these calls, they have no effect, and AL=02h always returns DL=FFh. 
Conflicts: None known. 


INTERRUPT 21h - Function 38h 
GET COUNTRY-SPECIFIC INFORMATION 


Purpose: Obtain certain information that varies with country. 


Available on: DOS 2.0 or higher. Restrictions: none. 
Registers at call: (DOS 2.x) Return Registers: 

AH = 38h CF set on error 

AL = 00h get current-country info AX = error code (02h) 
DS:DX -> buffer for returned info (Table 8-13) CF clear if successful 


AX = country code (MSDOS 2.11 only) 
buffer at DS:DX filled 


Registers at call: (DOS 3+) Return Registers: 

AH = 38h CF set on error 

AL = 00h for current country AX = error code (02h) 

AL = 01h thru OFEh for specific country with CF clear if successful 
code <255 BX = country code 

AL = OFFh for specific country with code >= 255 DS:DX buffer filled 


BX = 16-bit country code 
DS:DX -> buffer for returned info (Table 8-14) 
Conflicts: None known. 
See Also: Function 65h, INT 2Fh Function 11h Subfunction 0Ch (chapter 19), INT 2Fh Function 14h Subfunction 
04h 


Table 8-13. Format of PCDOS 2.x country info: 


Offset Size Description 

00h WORD date format: O=USA mmddyy 
1 = Europe dd mm yy 
2=Japan yy mmdd 

02h BYTE currency symbol 
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Table 8-13. Format of PCDOS 2.x country info: 


Offset Size Description 

03h BYTE 00h 

04h BYTE thousands separator char 
05h BYTE 00h 

06h BYTE decimal separator char 
07h BYTE 00h 

08h 24BYTEs reserved 


Table 8-14. Format of MSDOS 2.x,DOS 3+ country info: 











Offset Size Description 

00h WORD date format (see above) 

02h 5 BYTEs ASCIZ currency symbol string 

07h BYTE thousands separator char 

08h BYTE 00h 

09h BYTE decimal separator char 

OAh BYTE 00h 

OBh BYTE date separator char 

0Ch BYTE 00h 

ODh BYTE time separator char 

OEh BYTE 00h 

OFh BYTE currency format: 
bit2= set if currency symbol replaces decimal point 
bit | = number of spaces between value and currency symbol 
bitO= 0 if currency symbol precedes value 

1 if currency symbol follows value 
10h BYTE number of digits after decimal in currency 
1th BYTE time format: 


bitO= if 12-hour clock 
1 if 24-hour clock 


12h DWORD address of case map routine (FAR CALL, AL = char to map to upper case [>= 80h]) 
16h BYTE data-list separator char 
17h BYTE 00h 
18h 10 BYTEs reserved 
INTERRUPT 21h - Function 38h, Subfunction FFFFh 
SET COUNTRY CODE 
Purpose: Establish current "country code" to control country-specific information. 
Available on: DOS 3.0 or higher. Restrictions: none. 
Registers at call: Return Registers: 
AH = 38h CF set on error 
AL = 01h thru OFEh for specific country with AX = error code (see Function 59h) 
code <255 CF clear if successful 


AL =FFh for specific country with code >= 255 
BX = 16-bit country code 

DX = FFFFh 

Conflicts: None known. 

See Also: INT 2Fh Function 14h Subfunction 03h 


INTERRUPT 21h - Function 39h 
"WIKDIR" « CREATE SUBDIRECTORY 


Purpose: Create a new subdirectory in the current directory tree. 
Available on: DOS 2.0 or higher. Restrictions: none. 





8-24 MS-DOS and Compatibles 


Registers at call: 
AH = 39h 
DS:DX -> ASCIZ pathname 


Return Registers: 
CF clear if successful 
AX destroyed 
CF set on error 
AX = error code (03h,05h) (see Function 59h) 


Details: All directories in the given path except the last must exist. The call fails if the parent directory is the root 


and is full. 
Conflicts: None known. 


See Also: Functions 3Ah and 3Bh, INT 2Fh Function | 1h Subfunction 03h (chapter 19) 


INTERRUPT 21h - Function 3Ah 
"RMDIR" - REMOVE SUBDIRECTORY 


Purpose: Destroy a subdirectory. 

Available on: DOS 2.0 or higher. 

Registers at call: 

AH = 3Ah 

DS:DX -> ASCIZ pathname of directory to be 
removed. 


Details: The directory must be empty (contain only '.' and’. 


Conflicts: None known. 


Restrictions: none. 
Return Registers: 
CF clear if successful 
AX destroyed 
CF set on error 
AX = error code (03h,05h,06h, 10h) (Function 59h) 


.' entries), or this call will fail. 


See Also: Functions 39h and 3Bh, INT 2Fh Function 11h Subfunction 01h (chapter 19) 


INTERRUPT 21h - Function 3Bh 
"CHDIR" - SET CURRENT DIRECTORY 


Purpose: Changes "current" directory to that specified. 

Available on: DOS 2.0 or higher. 

Registers at call: 

AH = 3Bh 

DS:DX -> ASCIZ pathname to become current 
directory (max 64 bytes) 


Details: If the new directory name includes a drive letter, 
on that drive, Changing the current directory also changes 


Conflicts: None known, 


Restrictions: none. 
Return Registers: 
CF clear if successful 
AX destroyed 
CF set on error 
AX = error code (03h) (see Function 59h) 


the default drive is not changed, only the current directory 
the directory in which FCB file calls operate. 


See Also: Function 47h, INT 2Fh Function 11h Subfunction OSh (chapter 19) 


INTERRUPT 21h - Function 3Ch 
"CREAT" - CREATE OR TRUNCATE FILE 


Purpose: Create an empty file for writing. 
Available on: DOS 2.0 or higher. 
Registers at call: 
AH = 3CH 
CX = file attribute: 
bit 0: read-only 

: hidden 
: system 
: volume label (ignored) 
‘reserved, must be zero (directory) 
: archive bit 
: ifset, file is shareable under Novell 

NetWare 
DS:DX -> ASCIZ filename 


up wn— 


Restrictions: none. 
Return Registers: 
CF clear if successful 
AX = file handle 
CF set on error 
AX = error code (03h,04h,05h) (see Function 59h) 
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Details: If a file with the given name exists, it is truncated to zero length. 


Conflicts: None known. 
See Also: Functions 16h, 3Dh, 5Ah, and 5Bh 


INTERRUPT 21h - Function 3Dh 
"OPEN" - OPEN EXISTING FILE 


Purpose: Open file for reading, writing, or appending. 
Available on: DOS 2.0 or higher. 
Registers at call: 
AH = 3Dh 
AL = access and sharing modes: 
bits 2-0: access mode: 
000 read only 
001 write only 
010 read/write 
bit 3: reserved (0) 
bits 6-4: sharing mode (DOS 3+): 
000 compatibility mode 
001 "DENY ALL" prohibit both read and 
write access by others 
010 "DENY WRITE" prohibit write access 
by others 
O11 "DENYREAD" prohibit read access 
by others 
100 "DENYNONE" allow full access by 
others 
bit 7: inheritance: 
if set, the file is private to the current 
process and will not be inherited by 
child processes 
DS:DX -> ASCIZ filename 
CL = attribute mask for file (server call only), file 
will not be opened if it has any attributes 
other than the specified ones, read-only, 
or archive set. 


Restrictions: none. 
Return Registers: 
CF clear if successful 

AX = file handle 
CF set on error 
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AX = error code (01h,02h,03h,04h,05h,0Ch) (see 


Function 59h) 


Details: The file pointer is set to the start of the file. File handles which are inherited from a parent also inherit 
sharing and access restrictions. Files may be opened even if given the hidden or system attributes. 


Conflicts: None known. 


See Also: Functions OFh and 3Ch, Function 5Dh Subfunction 00h, INT 2Fh Function 12h Subfunction 26h 
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Table 8-15. File sharing behavior 


Second and subsequent Opens: 
Compat Deny Deny Deny Deny 





First All Write Read None 
Opened 
as: RWAW RWRW RWRW RWRW RWAW 
Compat R YYY NNN INN NNN INN 
Ww YYY NNN NNN NNN NNN 
RW YYY NNN NNN NNN NNN 
Deny R CCC NNN NNN NNN NNN 
All Ww ccc NNN NNN NNN NNN 
RW ccc NNN NNN NNN NNN 
Deny 2CC NNN YNN NNN YNN 
Write Ww CCC NNN NNN YNN YNN 
RW ccc NNN NNN NNN YNN 
Deny CCC NNN NYN NNN NYN 
Read Ww CCC NNN NNN NYN NYN 
RW CCC NNN NNN NNN NYN 
Deny R 2CC NNN YYY NNN YYY 
none WwW CCC NNN NNN YYY YYY 
RW CCC NNN NNN NNN YYY 
Legend: Y = open succeeds 


N = open fails with error code 05h 

C= open fails, INT 24h generated 

1 = open succeeds if file read-only, else fails with error code 
2 = open succeeds if file read-only, else fails with INT 24h 


INTERRUPT 21h - Function 3Eh 
"CLOSE" - CLOSE FILE 


Purpose: Force all buffers to be flushed and directory information updated, then invalidate the file handle, 


Available on: DOS 2.0 or higher. Restrictions: none. 
Registers at call: Return Registers: 
AH = 3Eh CF clear if successful 
BX = file handle AX destroyed 


CF set on error 
AX = error code (06h) (see Function 59h) 
Details: If the file was written to, any pending disk writes are performed, the time and date stamps are set to the 
current time, and the directory entry is updated. 
Conflicts: None known. 
See Also: Functions 10h, 3Ch, and 3Dh, INT 2Fh Function 11h Subfunction 06h (chapter 19), INT 2Fh Function 12h 
Subfunction 27h 


INTERRUPT 21h - Function 3Fh 


"READ" - READ FROM FILE OR DEVICE 


Purpose: Read data to the specified buffer from a file or device. 
Available on: DOS 2.0 or higher. Restrictions: none. 





| 





MS-DOS and Compatibles 8-27 


Registers at call: Return Registers: 

AH = 3Fh CF clear if successful 

BX = file handle AX = number of bytes actually read (0 if at BOF 
CX = number of bytes to read before call) 

DS:DX -> buffer for data CF set on error 


AX = error code (05h,06h) (see Function 59h) 
Details: Data is read beginning at the current file position, and the file position is updated after a successful read. 
The returned AX may be smaller than the request in CX if a partial read occurred. If reading from CON, read stops at 
first CR. 
Conflicts: None known. 
See Also: Functions 27h and 40h, INT 2Fh Function 11h Subfunction 08h (chapter 19), INT 2Fh Function 12h 


Subfunction 29h 


INTERRUPT 21h - Function 40h 
"WRITE" » WRITE TO FILE OR DEVICE 


Purpose: Write data from specified buffer to file or device. 


Available on: DOS 2.0 or higher. Restrictions: none. 

Registers at call: Return Registers: 

AH = 40h CF clear if successful 

BX = file handle AX = number of bytes actually written 

CX = number of bytes to write CF set on error 

DS:DX -> data to write AX = error code (05h,06h) (see Function 59h) 


Details: If CX is zero, no data is written, and the file is truncated or extended to the current position. Data is written 
beginning at the current file position, and the file position is updated after a successful write, The usual cause for AX 
<CX on return is a full disk. 

Conflicts: None known. 

See Also: Functions 28h and 3Fh, INT 2Fh Function 11h Subfunction 09h (chapter 19) 


INTERRUPT 21h - Function 41h 


"UNLINK” - DELETE FILE 
Purpose: Destroy the specified file. 
Available on: DOS 2.0 or higher. Restrictions: none. 
Registers at call: Return Registers: 
AH = 41h CF clear if successful 
DS:DX -> ASCIZ filename (no wildcards, but see AX destroyed (DOS 3.3), AL seems to be drive of 
below) deleted file 
CL = attribute mask (server call only, see below) CF set on error 
AX = error code (02h,03h,05h) (see Function 
59h) 


Details: DOS 3.1-+ allows wildcards if this function is invoked via Function 5Dh Subfunction 00h, in which case the 
filespec must be canonical (as returned by Function 60h), and only files matching the attribute mask in CL are 
deleted. 

DOS does not erase the file's data; it merely becomes inaccessible because the FAT chain for the file is cleared. 
Deleting a file which is currently open may lead to filesystem corruption. Unless SHARE is loaded, DOS does not 
close the handles referencing the deleted file, thus allowing writes to a nonexistant file. 

Conflicts: None known. 
See Also: Functions {3h and 60h, Function 5Dh Subfunction 00h, INT 2Fh Function 11h Subfunction 13h (chapter 
19) 


INTERRUPT 21h - Function 42h 
“LSEEK" - SET CURRENT FILE POSITION 


Purpose: Position to specified location in file. 
Available on: DOS 2.0 or higher. Restrictions: none. 
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Registers at call: Return Registers: 

AH = 42h CF clear if successful 

AL = origin of move: DX:AX = new file position in bytes from start of 
00h start of file file 
Oth current file position CF set on error 
02h end of file AX = error code (01h,06h) (see Function 59h) 


BX = file handle 

CX:DX = offset from origin of new file position 

Details: For origins 01h and 02h, the pointer may be positioned before the start of the file; no error is returned in that 
case, but subsequent attempts at I/O will produce errors. If the new position is beyond the current end of file, the file 
will be extended by the next write (see Function 40h), 

Conflicts: "Shake" virus (chapter 34), "Invader" virus (chapter 34), 

See Also: Function 24h, INT 2Fh Function 12h Subfunction 28h 


INTERRUPT 21h - Function 43h, Subfunction 00h 
GET FILE ATTRIBUTES 


Purpose: Determine control attributes for the specified file. 
Available on: DOS 2.0 or higher. 

Registers at call: 

AX = 4300h 

DS:DX -> ASCIZ filename 


Restrictions: none. 
Return Registers: 
CF clear if successful 
CX = attributes: 
bit 8: shareable (Novell NetWare) 
7; unused 
6: unused 
5: archive 
4: directory 
3: volume label 
2: system 
1: hidden 
0: read-only 
CF set on error 
AX = error code (01h,02h,03h,05h) (see Function 
59h) 
Conflicts: None known. 
See Also: Function 43h Subfunction 01h, Function B6h, INT 2Fh Function 11h Subfunction OFh (chapter 19) 


INTERRUPT 21h - Function 43h, Subfunction 01h 
"CHMOD" - SET FILE ATTRIBUTES 


Purpose: Sets control attributes for the specified file. 
Available on: DOS 2.0 or higher. 
Registers at call: 
AX = 4301h 
CX = new attributes: 
bit 8: shareable (Novell NetWare) 
7: unused 


Restrictions: none. 
Return Registers: 
CF clear if successful 

AX destroyed 
CF set on error 

AX = error code (01h,02h,03h,05h) (see Function 
6: unused 59h) 
5: archive 
4: directory (ignored) 
3: volume label (ignored) 
2: system 
1: hidden 

0: read-only 

DS:DX -> ASCIZ filename 
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Details: This function will not change the volume label or directory attributes. 
Conflicts: None known. 
See Also: Function 43h Subfunction 00h, INT 2Fh Function 11h Subfunction OEh (chapter 19) 


INTERRUPT 21h - Function 44h, Subfunction 00h 
IOCTL - GET DEVICE INFORMATION 


Purpose: Determine characteristics of specified file or device. 


Available on: DOS 2.0 or higher. Restrictions: none. 

Registers at call: Return Registers: 

AX = 4400h CF clear if successful 

BX = handle DX = device information word: 


character device if bit 7 set: 
14: device driver can process IOCTL requests 
(see Function 44h Subfunction 02h) 
13: output until busy supported 
11: driver supports OPEN/CLOSE calls 
: set (indicates device) 
: EOF on input 
: raw (binary) mode 
: device is special (uses INT 29h) 
: clock device 
: NUL device 
: standard output 
: standard input 
disk file if bit 7 clear: 
15: file is remote (DOS 3+) 
14: don't set file date/time on closing (DOS 3+) 
11: media not removable 
8: (DOS 4+) generate INT 24 if no disk space 
on write 
7; clear (indicates file) 
6: file has not been written 
5-0: drive number (0 = A:) 
CE set on error 
AX = error code (01h,05h,06h) (see Function 
59h) 
Details: The value in DH corresponds to the high byte of the device driver's attribute word if the handle refers to a 
character device. 
Conflicts: None known. 
See Also: Function 44h Subfunction 01h, INT 2Fh Function 12h Subfunction 2Bh 


INTERRUPT 21h - Function 44h, Subfunction 01h 
IOCTL - SET DEVICE INFORMATION 


Purpose: Set the changeable characteristics of the specified character device. 


O-nyNvEuara 


Available on: DOS 2.0 or higher. Restrictions: none. 

Registers at call: Return Registers: 

AX = 4401h CF clear if successful 

BX = handle (must refer to character device) CF set on error 

DX = device information word (see Function 44h AX = error code (01h,05h,06h,0Dh) (see Function 
Subfunction 00h) (DH must be zero) 59h) 


Conflicts: None known. 
See Also: Function 44h Subfunction 00h, INT 2Fh Function 12h Subfunction 2Bh 
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INTERRUPT 21h - Function 44h, Subfunction 02h 
IOCTL - READ FROM CHARACTER DEVICE CONTROL CHANNEL 


Purpose: Read data from the control channel of the specified device. 


Available on: DOS 2.0 or higher. Restrictions: Device driver must support the IOCTL 
call. 

Registers at call: Return Registers: 

AX = 4402h CF clear if successful 

BX = file handle referencing character device AX = number of bytes actually read 

CX = number of bytes to read CF set on error 

DS:DX -> buffer AX = error code (01h,05h,06h,0Dh) (see Function 

59h) 


Details: The format of the data is driver-specific, 

Conflicts: SMARTDRV (chapter 6), Network Driver Interface Specification (chapter 27), IBM System 36/38 
Workstation Emulation (chapter 26), HIGHUMM.SYS IOCTL (chapter 36), LASTBYTE.SYS (chapter 36). 

See Also: Function 44h Subfunctions 00h, 03h, and 04h, INT 2Fh Function 12h Subfunction 2Bh 


INTERRUPT 2th - Function 44h, Subfunction 03h 
IOCTL - WRITE TO CHARACTER DEVICE CONTROL CHANNEL 


Purpose: Write data to the control channel of the specified device. 


Available on: DOS 2.0 or higher. Restrictions: Device driver must support the IOCTL 
call, 

Registers at call: Return Registers: 

AX = 4403h CF clear if successful 

BX = file handle referencing character device AX = number of bytes actually written 

CX = number of bytes to write CF set on error 

DS:DX -> data to write AX = error code (01h,05h,06h,0Dh) (see Function 

59h) 


Details: The format of the data is driver-specific. If the file handle refers to "4DOSSTAK" (or "NDOSSTAK"), the 
4DOS (or NDOS) KEYSTACK.SYS driver will push the specified characters on the keyboard stack. 

Conflicts: SMARTDRV (chapter 6). 

See Also: Function 44h Subfunctions 00h, 02h, and 05h, INT 2Fh Function 12h Subfunction 2Bh, INT 2Fh Function 
D4h Subfunction 4Dh 


INTERRUPT 21h - Function 44h, Subtunction 04h 
IOCTL - READ FROM BLOCK DEVICE CONTROL CHANNEL 


Purpose: Read data from the control channel of the specified device. 


Available on: DOS 2.0 or higher. Restrictions: Device driver must support the IOCTL 
call, 

Registers at call: Return Registers: 

AX = 4404h CF clear if successful 

BL = drive number (00h = default, 01h = A:, etc) AX = number of bytes actually read 

CX = number of bytes to read CF set on error 

DS:DX -> buffer AX = error code (01h,05h,06h,0Dh) (see Function 

59h) 


Details: The format of the data is driver-specific. 
Conflicts: None known, 
See Also: Function 44h Subfunctions 02h and OSh, INT 2Fh Function 12h Subfunction 2Bh 


INTERRUPT 21h - Function 44h, Subfunction 05h 
IOCTL - WRITE TO BLOCK DEVICE CONTROL CHANNEL 


Purpose: Write data to the control channel of the specified device. 
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Available on: DOS 2.0 or higher. Restrictions: Device driver must support the IOCTL 
call, 

Registers at call: Return Registers: 

AX =4405h CF clear if successful 

BL = drive number (OOh = default, 01h = A:, etc) AX = number of bytes actually written 

CX = number of bytes to write CF set on error 

DS:DX -> data to write AX =error code (01h,05h,06h,0Dh) (see Function 

59h) 


Details: The format of the data is driver-specific. 
Conflicts: None known. 
See Also: Function 44h Subfunctions 03h and 04h, INT 2Fh Function 12h Subfunction 2Bh 


INTERRUPT 21h - Function 44h, Subfunction 06h 


{OCTL « GET INPUT STATUS 

Purpose: Get input status of specified device. 

Available on: DOS 2.0 or higher. Restrictions: none. 

Registers at call: Return Registers: 

AX = 4406h CF clear if successful 

BX = file handle AL = input status: 
00h not ready (device) or at EOF (file) 
FFh ready 


CF set on error 
AX = error code (01h,05h,06h,0Dh) (see Function 
59h) 
Details: Files may not register as being at EOF if positioned there by Function 42h. 
Conflicts: None known. 
See Also: Function 44h Subfunction 07h, INT 2Fh Function 12h Subfunction 2Bh 


INTERRUPT 21h - Function 44h, Subfunction 07h 
IOCTL - GET OUTPUT STATUS 


Purpose: Get output status of specified device. 


Available on: DOS 2.0 or higher. Restrictions: none. 
Registers at call: Return Registers: 
AX = 4407h CF clear if successful 
BX = file handle AL = input status: 
00h not ready 
FFh ready 


CF set on error 
AX = error code (01h,05h,06h,0Dh) (see Function 
59h) 
Details: For DOS 2+, files are always ready for output. 
Conflicts: None known. 
See Also: Function 44h Subfunction 06h, INT 2Fh Function 12h Subfunction 2Bh 


INTERRUPT 21h - Function 44h, Subfunction 08h 


IOCTL - CHECK IF BLOCK DEVICE REMOVABLE 


Purpose: Determine whether the specified device has removeable media, 
Available on: DOS 3.0 or higher. Restrictions: none. 
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Registers at call: 
AX = 4408h 
BL = drive number (00h = default, 01h = A:, etc) 


Conflicts; None known. 


Return Registers: 
CF clear if successful 
AX = 0000h if removable 
000 1h if fixed 
CF set on error 
AX = error code (01h,OFh) (see Function 59h) 


See Also: Function 44h Subfunctions 00h and 09h, INT 2Fh Function 12h Subfunction 2Bh 


INTERRUPT 2%h - Function 44h, Subfunction 09h 


IOCTL - CHECK IF BLOCK DEVICE REMOTE 


Purpose: Determine whether the specified device is local or remote. 


Available on: DOS 3.1 or higher. 

Registers at call: 

AX = 4409h 

BL = drive number (00h = default, 01h = A:, etc) 


Restrictions: none. 
Return Registers: 
CF clear if successful 
DX = device attribute word: 
bit 15: drive is SUBSTituted 
bit 12: drive is remote 
bit 9: direct I/O not allowed 
CF set on error 
AX = error code (01h,OFh) (see Function 
59h) 


Details: On local drives, DX bits not listed above are the attribute word from the device driver header (see Function 


52h); for remote drives, the other bits appear to be undefined. 


Conflicts: None known. 


See Also: Function 44h Subfunctions 00h, 08h, and OAh, INT 2Fh Function 12h Subfunction 2Bh 


INTERRUPT 21h - Function 44h, Subfunction OAh 


IOCTL - CHECK IF HANDLE IS REMOTE 


Purpose: Determine whether the specified handle refers to a file on a remote device. 


Available on: DOS 3.1 or higher. 
Registers at call: 

AX = 440Ah 

BX = handle 


Restrictions: none. 
Return Registers: 
CF clear if successful 
DX = attribute word (as stored in SFT) 
bit 15: set if remote 
CF set on error 
AX = error code (01h,06h) (see Function 59h) 


Details: If the file is remote, Novell Advanced NetWare 2.0 returns the number of the file server on which the 


handle is located in CX. 
Conflicts: None known. 


See Also: Function 44h Subfunctions 00h and 09h, Function 52h, INT 2Fh Function 12h Subfunction 2Bh 


INTERRUPT 21h - Function 44h, Subfunction OBh 


OCTL - SET SHARING RETRY COUNT 


Purpose: Establish the number of retries to be used in case of a SHARE failure on opening or locking a file. 


Available on: DOS 3,1 or higher. 
Registers at call: 

AX = 440Bh 

CX = pause between retries (default 1) 
DX = number of retries (default 3) 


Restrictions: none. 
Return Registers: 
CF clear if successful 
CF set on error 
AX = error code (01h) (see Function 59h) 


Details: The delay is dependent on the processor's speed (the value in CX specifies the number of 64K- iteration 
empty loops to execute), If DX=0000h on entry, the retry count is left unchanged. 


Conflicts: None known. 
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See Also: Function 52h, INT 2Fh Function 12h Subfunctions 24h and 2Bh 


INTERRUPT 21h - Function 44h, Subfunction 0Ch 
IOCTL - GENERIC CHARACTER DEVICE REQUEST 


Purpose: Miscellaneous requests to character device drivers. 


Available on: DOS 3.2 or higher. Restrictions: none. 
Registers at call: Return Registers: 
AX = 440Ch CF set on error 
BX = device handle AX = error code (see Function 59h) 
CH = category code: CF clear if successful 
00h unknown (DOS 3.3+) DS:DX -> iteration count if CL=65h 
Oh COMn: (DOS 3.3+) DS:DX -> (OS/2 comp box) data block 
03h CON (DOS 3.3+) 
05h LPTn: 
9Eh Media Access Control driver 
(STARLITE) 


CL = function: 
00h MAC driver Bind (STARLITE) 
45h set iteration count 
4Ah select code page 
ACh start code-page preparation 
4Dh end code-page preparation 
5Fh set display information (DOS 4.0) 
65h get iteration count 
6Ah query selected code page 
6Bh query prepare list 
7h get display information (DOS 4.0) 
DS:DX -> (DOS) parameter block (Tables 8-16 
thru 8-22) 
$I:DI -> (OS/2 comp box) parameter block 
(Tables 8-16 thru 8-22) 
Conflicts: None known. 
See Also: Function 44h Subfunctions ODh and 10h, INT 2Fh Function 08h Subfunction 02h, INT 2Fh Function 12h 
Subfunction 2Bh, INT 2Fh Function 1Ah Subfunction 01h 


Table 8-16, Format of parameter block for function 00h: 


Offset Size Description 

00h 8BYTEs ASCIZ signature "STARMAC" 
08h WORD version 

OAh WORD flags: 


bit 0; media requires connect or listen request before use 
bit 1: network is a LAN (broadcast/multicast supported) 
bit 2: point-to-point network 


0Ch WORD handle for use with MAC driver's private interface (filled in by MAC driver) 
OEh WORD context 

10h WORD approximate speed in KB/sec (filled in by MAC driver) 

12h WORD approximate cost in cents per hour (filled in by MAC driver) 

14h WORD maximum packet size in bytes (filled in by MAC driver) 

16h WORD addressing format (filled in by MAC driver) 


0000h general addressing 

0001h Ethernet addressing 

0002h Token Ring addressing 

0003h Token Bus addressing 
18h DWORD _ Send entry point (filled in by MAC driver) 
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Table 8-16. Format of parameter block for Junction 00h (continued) 


Offset Size Description 

1Ch DWORD _ RegisterEventHandler entry point (filled in by MAC driver) 
20h DWORD _ SetPacketFilter entry point (filled in by MAC driver) 

24h DWORD — UnBind entry point (filled in by MAC driver) 


Table 8-17. Format of parameter block for function 45h: 


Offset Size Description 
00h WORD number of times output is attempted before driver assumes device is busy 


Table 8-18. Format of parameter block for functions 4Ah and 6Ah: 


Offset Size Description 

001 WORD length of data 

02h WORD code page ID 

04h 2N BYTEs DCBS (double byte character set) lead byte range start/end for each of N ranges (DOS 4.0) 


WORD 0000h end of data (DOS 4.0) 


Table 8-19. Format of parameter block for function 4Ch: 


Offset Size Description 

00h WORD flags: 

DISPLAY.SYS = 0000h 7 

PRINTER.SYS bit 0 clear to prepare downloaded font, set to prepare cartridge selection 





02) WORD length of remainder of parameter block 
04h WORD number of code pages following 
06! NWORDs code page 1,...,N 


Table 8-20. Format of parameter block for function 4Dh: 


Offset Size Description 
00h WORD length of data 
02h WORD code page ID 


Table 8-21, Format of parameter block for functions 5Fh and 7Fh: 


Offset Size Description 

00h BYTE level (0 for DOS 4.x and 5.0) 
Olh BYTE reserved (0) 

02h WORD length of following data (14) 
04h WORD control flags: 


bit 0 set for blink, clear for intensity 
bits 1 to 15 reserved 


06h BYTE mode type (1=text, 2=graphics) 
07h BYTE reserved (0) 
08h WORD colors: 


0 = monochrome 
else N bits per pixel 


OAh WORD pixel columns 
OC! WORD pixel rows 
OE! WORD character columns 








10 WORD character rows 
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Table 8-22. Format of parameter block for function OBh: 


Offset Size Description 

00h WORD length of following data 

02h WORD number of hardware code pages 
04h N WORDs hardware code pages I.,...,N 


WORD number of prepared code pages 
N WORDs prepared code pages 1,...,N 


INTERRUPT 21h - Function 44h, Subfunction 0Dh 
IOCTL - GENERIC BLOCK DEVICE REQUEST 


Purpose: Miscellaneous requests to block device drivers. 


Available on: DOS 3.2 or higher. Restrictions: none. 
Registers at call: Return Registers: 
AX =440Dh CF set on error 
BL = drive number (OOh=default,01h=A:,etc) AX = error code (see Function 59h) 
CH = category code: CF clear if successful 
O8h disk drive DS:DX -> data block if CL=60h or CL=61h 


CL = function: 
40h set device parameters 
41h write logical device track 
42h format and verify logical device track 
46h (DOS 4.0) set volume serial number 
(see also Function 69h) 
47h (DOS 4.0) set access flag 
60h get device parameters 
61h read logical device track 
62h verify logical device track 
66h (DOS 4.0) get volume serial number 
(see also Function 69h) 
67h (DOS 4.0) get access flag 
DS:DX -> (DOS) parameter block 
(Tables 8-23 thru 8-27) 
SI:DI -> (OS/2 comp box) parameter block 
(Tables 8-23 thru 8-27) 
Details: DOS 4.01 seems to ignore the high byte of the number of directory entries in the BPB for diskettes. 
Function codes 46h and 66h were undocumented in DOS 4.x, but are documented for DOS 5.0. 
Conflicts: None known. 





See Also: Function 44h Subfunctions 0Ch and 11h, Function 69h, INT 2Fh Function 08h Subfunction 02h, INT 2Fh 


Function 12h Subfunction 2Bh 


Table 8-23. Format of parameter block for functions 40h, 60h: 


Offset Size Description 
00h BYTE special functions: 
bit 0 set if function to use current BPB, clear if Device BIOS Parameter Block field 
contains new default BPB 
bit 1 set if function to use track layout fields only must be clear if CL=60h 
bit 2 set if all sectors in track same size (should be set) 
bits 3-7 reserved 
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Table 8-23. Format of parameter block for functions 40h, 60h (continued) 


Offset Size Description 

Olh BYTE device type: 
00h 320K/360K disk 
Olh 1.2M disk 


02h 720K disk 
03h single-density 8-inch disk 
04h double-density 8-inch disk 
05h fixed disk 
06h tape drive 
O7h 1.44M disk 
O8h_ other type of block device 
02h WORD device attributes: 
bit 0 set if nonremovable medium 
bit I set if door lock supported 
bits 2-15 reserved 
04h WORD number of cylinders 
06h BYTE media type: 
for 1.2M drive: 
00h 1.2M disk (default) 
Oth 320K/360K disk 
always 00h for other drive types 


07h 31 BYTEs device BPB (see Function 53h), bytes after BPB offset 1Eh omitted 
26h WORD number of sectors per track (start of track layout field) not used by function 60h 
28h N word pairs: number,size of each sector in track 


Table 8-24, Format of parameter block for functions 41h, 61h: 


Offset Size Description 

00h BYTE special functions (reserved, must be zero) 
Oih WORD number of disk head 

03h WORD number of disk cylinder 

05h WORD number of first sector to read/write 

O7h WORD number of sectors 

09h DWORD _ transfer address 


Table 8-25, Format of parameter block for functions 42h, 62h: 


Offset Size Description 

00h BYTE reserved, must be zero (DOS <3.2) 
bit O=0; format/verify track 

1: format status call (DOS 3.2-+) 

bits [-7 reserved, must be zero on return (DOS 4.0): 
bit 0: set if specified tracks, sectors/track supported 
bit 1: set if function not supported by BIOS 
bit 2: set if specified tracks, sectors/track not supported 
bit 3: set if no disk in drive 

Olh WORD number of disk head 

03h WORD number of disk cylinder 


Table 8-26. Format of parameter block for functions 46h, 66h: 


Offset Size Description 

00h WORD info level (00h) 

02h DWORD _ disk serial number (binary) 

06h 11 BYTEs volume label or "NO NAME " 


11h 8BYTEs filesystem type "FATI2 "or"FATI6 "(CL=66h only) 
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Table 8-27. Format of parameter block for functions 47h, 67h: 


Offset Size Description 
00h BYTE special-function field (must be zero) 
Olh BYTE disk-access flag, nonzero if access allowed by driver 


INTERRUPT 21h - Function 44h, Subfunction OEh 
JOCTL » GET LOGICAL DRIVE MAP 


Purpose: Determine last letter used to reference the specified drive. 


Available on: DOS 3.2 or higher, Restrictions: none. 

Registers at call: Return Registers: 

AX = 440Eh CF set on error 

BL = drive number (OOh=default, OLh=A:, etc) AX = error code (01h,OFh) (see Function 59h) 


CF clear if successful 
AL = 00h block device has only one logical drive 
assigned 
1.26 the last letter used to reference the 
drive (1#A:,etc) 
Conflicts: None known. 
See Also: Function 44h Subfunction 0Fh, INT 2Fh Function 12h Subfunction 2Bh 


INTERRUPT 21h - Function 44h, Subfunction OFh 
IOCTL - SET LOGICAL DRIVE MAP 


Purpose: Maps logical drives to physical drives, similar to DOS's treatment of a single physical floppy drive as both 
A:and B:. 


Available on: DOS 3.2 or higher. Restrictions: none. 

Registers at call: Return Registers: 

AX = 440Fh CE set on error 

BL = physical drive number (OOh=default, OLh=A:, AX = error code (01h,OFh) (see Function 59h) 
ete) CF clear if successful 


drive now responds to next logical drive number 


Conflicts: None known. 
See Also: Function 44h Subfunction OEh, INT 2Fh Function 12h Subfunction 2Bh 


INTERRUPT 21h - Function 44h, Subfunction 10h 
IOCTL - QUERY GENERIC IOCTL CAPABILITY (HANDLE) 


Purpose: Determine whether a character device supports a particular generic IOCTL call. 


Available on: DOS 5.0 or higher. Restrictions: device driver must support Generic 
IOCTL Check call, 
Registers at call: Return Registers: 
AX = 4410h CF clear if successful 
BX = handle for device AX=0000h — specified OCTL function is 
CH = category code (see Function 44h Subfunction supported 
OCh) CF set on error 
CL = function code AL #=0lh IOCTL capability not available 


Details: A program which wishes to use Generic IOCTL calls beyond the basic set of calls defined for DOS 3.2 may 
use this call to verify whether a particular call is supported by the driver. 

Conflicts: NewSpace (chapter 6) 

See Also: Function 44h Subfunctions 0Ch and 11h 
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INTERRUPT 21h - Function 44h, Subfunction 11h 
IOCTL - QUERY GENERIC JOCTL CAPABILITY (DRIVE) 


Purpose: Determine whether a block device supports a particular generic IOCTL call. 


Available on; DOS 5.0 or higher. Restrictions: device driver must support Generic 
IOCTL Check call. 
Registers at call: Return Registers: 
AX =4411h CF clear if successful 
BL = drive number AX=0000h — specified IOCTL function is 
CH = category code (see Function 44h Subfunction supported 
ODh) CF set on error 
CL = function code AL=0Ih IOCTL capability not available 


Details: A program which wishes to use Generic IOCTL calls beyond the basic set of calls defined for DOS 3.2 may 
use this call to verify whether a particular call is supported by the driver. 

Conflicts: NewSpace (chapter 6) 

See Also: Function 44h Subfunctions 0Dh and 10h 


INTERRUPT 21h - Function 45h 
"DUP" - DUPLICATE FILE HANDLE 


Purpose: Creates new file handle that references the specified file or device via the same System File Table entry. 


Available on: DOS 2.0 or higher. Restrictions: none. 
Registers at call: Return Registers: 
AH = 45h CF clear if successful 
BX = file handle AX = new handle 


CF set on error 
AX = error code (04h,06h) (see Function 59h) 
Details: Moving the file pointer for either handle will also move it for the other, because both refer to the same 
system file table. For DOS versions prior to 3.3, file writes may be forced to disk by duplicating the file handle and 
closing the duplicate; DOS 3.3 and up provide a function for that purpose. 
Conflicts; None known. 
See Also: Functions 3Dh and 46h 


INTERRUPT 21h - Function 46h 
“DUP2", "FORCEDUP" - FORCE DUPLICATE FILE HANDLE i 


Purpose: Forces a particular handle to become a duplicate of the specified handle. 


Available on: DOS 2.0 or higher. Restrictions: none. 

Registers at call: Return Registers: 

AH = 46h CF clear if successful 

BX = file handle CF set on error 

CX = file handle to become duplicate of first handle AX = error code (04h,06h) (see Function 59h) 


Details: Closes file with handle BX if it is still open. DOS 3,30 hangs if BX=CX on entry. Moving the file pointer 
for either handle will also move it for the other, because both will refer to the same system file table. 

Conflicts: None known. 

See Also: Functions 3Dh and 45h 


INTERRUPT 21h - Function 47h 
"CWD" . GET CURRENT DIRECTORY 


Purpose: Determine current working directory, 
Available on: DOS 2.0 or higher. Restrictions: none. 


Registers at call: 

AH = 47h 

DL = drive number (00h = default, 01h = A:, etc) 
DS:SI -> 64-byte buffer for ASCIZ pathname 
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Return Registers: 
CF clear if successful 
AX = 0100h (undocumented) 
CF set on error 
AX = error code (OFh) (see Function 59h) 


Details: The returned path does not include a drive or the initial backslash. Many Microsoft products for Windows 


rely on AX being 0100h on success. 
Conflicts: None known. 
See Also: Functions 19h and 3Bh 


INTERRUPT 21h - Function 48h 

ALLOCATE MEMORY 

Purpose: Assigns memory for program use, if available. 
Available on: DOS 2.0 or higher. 

Registers at call: 

AH = 48h 

BX = number of paragraphs to allocate 


Restrictions: none. 

Return Registers: 

CF clear if successful 
AX = segment of allocated block 

CF set on error 
AX = error code (07h,08h) (see Function 59h) 
BX = size of largest available block 


Details: DOS 3.30 coalesces free blocks while scanning for a block to allocate. 

COM-format programs are initially allocated the largest available memory block, and should free some memory 
with Function 49h before attempting any allocations. EXE-format programs are initially allocated memory as 
specified in their headers (most compilers set the allocation such that the program is given the largest available 


memory block). 
Conflicts: None known. 
See Also: Functions 49h, 4Ah, and 58h 


INTERRUPT 21h - Function 49h 

FREE MEMORY 

Purpose: Releases allocated memory blocks. 
Available on; DOS 2.0 or higher. 

Registers at call: 

AH = 49h 

ES = segment of block to free 


Details: Apparently never returns an error O7h, despite offici 


Restrictions: none. 
Return Registers: 
CF clear if successful 
CF set on error 
AX = error code (07h,09h) (see Function 59h) 


al documentation; DOS 3,30 code contains only an error 


09h exit. DOS 3.30 does not coalesce adjacent free blocks when a block is freed, only when a block is allocated or 


resized, 
Conflicts: None known. 
See Also: Function 48h and 4Ah 


INTERRUPT 21h - Function 4Ah 
RESIZE MEMORY BLOCK 


Purpose: Changes the size of a previously-allocated memory block, if possible. 


Available on: DOS 2.0 or higher. 
Registers at call: 

AH =4Ah 

BX = new size in paragraphs 

ES = segment of block to resize 


Restrictions: none. 
Return Registers: 
CF clear if successful 
CF set on error 
AX = error code (07h,08h,09h) (see Function 
59h) 
BX = maximum paragraphs available for 
specified memory block 
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Details: Under PCDOS 2.1 and 3.1 and MSDOS 3.2 and 3.3, if there is insufficient memory to expand the block as 
much as requested, the block will be made as large as possible. DOS 3.30 coalesces any free blocks immediately 
following the block to be resized, 

Conflicts: None known. 

See Also: Function 48h and 49h 


INTERRUPT 21h - Function 4Bh, Subfunctions 00h-04h 
"EXEC" - LOAD AND/OR EXECUTE PROGRAM 


Purpose: Dispatch a child process, or optionally load a program without dispatching it, 


Available on: DOS 2.0 or higher. Restrictions: none. 
Registers at call: Return Registers: 
AH =4Bh CF clear if successful 
AL = type of load: BX,DX destroyed 

00h load and execute If subfunction O1h, the current process ID 

Oth load but do not execute is set to the new program's PSP; get it with 

03h load overlay INT 21h Function 62h 

04h load and execute in background (European CF set on error 

OEM MSDOS 4.00 only) AX = error code (01h,02h,05h,08h,0Ah,0Bh) (see 
DS:DX -> ASCIZ program name (must include Function 59h) 
extension) 


ES:BX -> parameter block (Tables 8-28, 8-29) 

Details: DOS 2.x destroys all registers, including SS:SP. For functions 00h, OLh, and 04h, the calling process must 

ensure that there is enough unallocated memory available; if necessary, by releasing memory with Function 49h or 

Function 4Ah. For function 03h, DOS assumes that the overlay is being loaded into memory allocated by the caller. 
Function 01h has been documented for DOS 5.0, but was undocumented in prior versions. 

BUG: DOS 2.00 assumes that DS points at the current program's PSP, 

Conflicts: ELRES V1.0 (chapter 36), "MG" virus (chapter 34), "699" virus (chapter 34), "Plastique" virus (chapter 

34), "Murphy-2" virus (chapter 34), "Plastique-2576" virus (chapter 34), "Murphy-1" virus (chapter 34), 

“Nomenklatura” virus (chapter 34), "948" virus, "Magnitogorsk" virus (chapter 34), "Lozinsky" virus (chapter 34), B- 

DRIVER.SYS v1.14+ (chapter 34), "707" virus, "Justice" virus (chapter 34), 

See Also: Functions 4Ch and 4Dh, INT 2Eh 


Table 8-28. Format of EXEC parameter block for AL=00h, O1h, 04h: 


Offset Size Description 

00h WORD segment of environment to copy for child process (copy caller's environment if 0000h) 
02h DWORD pointer to command tail to be copied into child's PSP 

06h DWORD pointer to first FCB to be copied into child's PSP 

OAh DWORD _ pointer to second FCB to be copied into child's PSP 

OEh DWORD  (AL=0!nh) will hold subprogram’s initial SS:SP on return 

12h DWORD  (AL=01h) will hold entry point (CS:IP) on return 


Table 8-29. Format of EXEC parameter block for AL=O3h: 


Offset Size Description 
00h WORD segment at which to load overlay 
02h WORD relocation factor to apply to overlay if in EXE format 


Table 8-30. Format of EXE. file header: 


Offset Size Description 

00h 2BYTEs .EXE signature, either "MZ" or "ZM" (SA4Dh or 4DSAh) 

02h WORD number of bytes in last 5 12-byte page of executable 

04h WORD total number of 512-byte pages in executable (includes any partial last page) 


06h WORD number of relocation entries 
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Table 8-30. Format of .EXE file header (continued) 


Offset Size Description 

O8h WORD header size in paragraphs 

OAh WORD minimum paragraphs of memory to allocation (in addition to executable's size) 
0Ch WORD maximum paragraphs to allocate (in addition to executable's size) 

OEh WORD initial SS relative to start of executable 

10h WORD initial SP 

12h WORD checksum (one's complement of sum of all words in the executable) 

14h DWORD _ initial CS:IP relative to start of executable 

18h WORD offset within header of relocation table 

{Ah WORD overlay number (normally 0000h = main program) 
~--Borland TLINK 

Ich 2BYTEs unknown. (apparently always O1h 00h) 

1Eh BYTE signature FBh 

1Fh BYTE TLINK version (major in high nybble, minor in low nybble) 

20h 2BYTEs unknown. (v2.0 apparently always 72h 6Ah, v3.0 seems always 6Ah 72h) 
---other linkers 

1Ch var optional information 

N N DWORDs relocation items 


Details: If the word at offset 02h is 4, it should be treate 


memory as possible. The maximum allocation is set to FFFFh paragraphs by default. 


Table 8-31. Format of new executable header: 


Offset 
00h 
02h 
04h 
06h 
08h 
0Ch 


0ODh 


Size 

2 BYTEs 
2 BYTEs 
WORD 
WORD 
DWORD 
BYTE 


BYTE 


WORD 
WORD 
WORD 
DWORD 
DWORD 
WORD 


Description 
"NE" (4Eh 45h) signature 
linker version (major, then minor) 
offset to entry table 
length of entry table in bytes 
file load CRC (0 in Borland’s TPW) 
program flags 
bits 0-1 DGROUP type 
0 =none 
[ = single shared 
2. = multiple (unshared) 
3 = (null) 
bit 2: global initialization 
bit 3: protected mode only 
bit 4: 8086 instructions 
bit 5: 80286 instructions 
bit 6: 80386 instructions 
bit 7: 80x87 instructions 
application flags 
bits 0-1: API awareness 
O! full screen (not aware of Windows/P.M. API) 
10 compatible with Windows/P.M, API 
11 uses Windows/P.M. API 
bit 5: errors in image 
bit 7: DLL 
auto data segment index 
initial local heap size 
initial stack size 
program entry point (CS:IP) 
initial stack pointer (SS:SP) 
segment count 


d as 00h, since pre-1.10 versions of the MS linker set it that 
way. If both minimum and maximum allocation (offsets OAh/OCh) are zero, the program is loaded as high in 
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Table 8-31. Format of new executable header (continued) 





Offset Size Description 
1Eh WORD module reference count 
20h WORD length of nonresident names table 
22h WORD offset to segment table (see below) 
24h WORD offset to resource table 
26 WORD offset to resident names table 
28h WORD offset to module reference table 
2Ah WORD offset to imported names table 
2Ch DWORD _ offset to nonresident names table 
30h WORD moveable entry point count 
32 BYTE file alignment shift size 
33h 3BYTEs unknown, 
36) BYTE operating system 
Oth OS/2 
02h Windows 
37h BYTE other EXE flags 
bit 0: supports long filenames 
bit 1: 2.X protected mode 
bit 2: 2.X proportional font 
bit 3: gangload area 
38h WORD offset to return thunks or start of gangload area 
3Ah WORD offset to segment reference thunks or length of gangload area 
3Ch WORD minimum code swap area size 
3Eh 2BYTEs expected Windows version (minor version first) 


Table 8-32. Format of segment table record: 


Offset Size Description 
00h WORD offset in file (shifted right by alignment shifo) 
02h WORD length of image in file 
04h WORD attributes 
bit 0,1,2: DATA segment flags 
bit 3: iterated 
bit 4: movable 
bit 5: sharable 


bit 6: preloaded 

bit 7: execute-only 

bit 8: relocations (directly following code for this segment) 
bit 9: debug info 

bits 10,11: 80286 DPL bits 

bit 12: discardable 

bits 13-15: discard priority 


06h WORD size to allocate 

INTERRRUPT 21h - Function 4Bh, Subfunction 05h 

SET EXECUTION STATE 

Purpose: May be used by programs which wish to bypass the normal EXEC function. 
Available on: DOS 5.0 or higher. Restrictions: none. 
Registers at call: Return Registers: 

AX = 4B05h CF clear if successful 
DS:DX -> execution state structure (Table 8-33) AX = 0000h 


CF set on error 


AX = error code (see Function 59h) 
Details: Used by programs which intercept Function 4Bh Subfunction 00h to prepare new programs for execution 
(including setting the DOS version number). No DOS, BIOS or other software interrupts may be called after return 
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from this call before commencement of the child process. If DOS is running in the HMA, A20 is turned off on return 


from this call. 
Conflicts; None known, 
See Also: Function 4Bh Subfunctions 00h-04h 


Table 8-33. Format of execution state structure: 


Offset Size Deseription 
00h WORD reserved (00h) 
02h WORD type flags 


bit 0: program is an EXE 
1: program is an overlay 


04h DWORD pointer to ASCIZ name of program file 
08h WORD PSP segment of new program 

O0Ah DWORD _ starting CS:IP of new program 

OEh DWORD program size including PSP 


INTERRUPT 21h - Function 4Ch 
"EX{T" - TERMINATE WITH RETURN CODE 


Purpose: Ends current process and returns to parent (usually command interpreter), 
completion status. 


passing exit code to indicate 


Available on: DOS 2.0 or higher. Restrictions: none, 
Registers at call: Return Registers: 
AH =4Ch never returns 


AL = return code 

Details: Unless the process is its own parent (see Function 26h, offset 16h in PSP), all open files are closed and all 
memory belonging to the process is freed. All network file locks should be removed before calling this function. 
Conflicts: None known. 

See Also: Functions 00h, 26h, 4Bh, and 4Dh, INT 20h, INT 22h 


INTERRUPT 21h - Function 4Dh 


GET RETURN CODE 

Purpose: Reads exit code returned by Function 31h or 4Ch. 

Available on: DOS 2.0 or higher. Restrictions: none. 
Registers at call: Return Registers: 

AH = 4Dh AH = termination type: 


00h normal (INT 20h, INT 21h 
Function 00h, or INT 21h Function 4Ch) 
O1h control-C abort 
02h critical error abort 
03h terminate and stay resident (INT 21h 
Function 31h or INT 27h) 
AL = return code 
Details: The word in which DOS stores the return code is cleared after being read by this function, so the return code 
can be retrieved only once. 
Conflicts: None known. 
See Also: Function 4Bh and 4Ch 


INTERRUPT 21h - Function 4Eh 
"FINDFIRST" - FIND FIRST MATCHING FILE 


Purpose: Locates the first file matching a specified pathspec and supplies information about it. 
Available on: DOS 2.0 or higher. Restrictions: none. 
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Registers at call: Return Registers: 

AH =4Eh CF clear if successful 

CX = file attribute mask (see Function 43h [DTA] = FindFirst data block (Table 8-34) 
Subfunction 01h) (bits 0 and 5 ignored) CF set on error 

DS:DX -> ASCIZ file specification (may include AX = error code (02h,03h,12h) (see Function 
path and wildcards) 59h) 


Details: For search attributes other than 08h, all files with at most the specified combination of hidden, system, and 
directory attributes will be returned, Under DOS 2.x, searching for attribute 08h (volume label) will also return 
normal files, while under DOS 3+ only the volume label (if any) will be returned, 
This call also returns successfully if given the name of a character device without wildcards. DOS 2.x returns 
attribute OOh, size 0, and the current date and time. DOS 3+ returns attribute 40h and the current date and time. 
Under LANtastic, this call may be used to obtain a list of a server's shared resources by searching for 
'\SERVER.*"; a list of printer resources may be obtained by searching for 'NSERVER*,#", 
BUG: Under DOS 3.x and 4.x, the second and subsequent calls to this function with a character device name (no 
wildcards) and search attributes which include the volume-label bit (08h) will fail unless there is an intervening DOS 
call which implicitly or explicity performs a directory search without the volume-label bit. Such implicit searches are 
performed by CREATE (Function 3Ch), OPEN (Function 3Dh), UNLINK (Function 41h), and RENAME (Function 
56h). 
Conflicts: WILDUNIX.COM Installation Check (chapter 36), 
See Also: Functions 11h and 4Fh, Function 43h Subfunction Olh, INT 2Fh Function 11h Subfunction 1Bh (chapter 
19) 


Table 8-34. Format of FindFirst data block: 


Offset Size Description 
--PCDOS 3.10, PCDOS 4.01, MSDOS 3.2/3,3/5.0 
00h BYTE drive letter 
Olh 11 BYTEs search template 
0Ch BYTE search attributes 
--DOS 2.x (and some DOS 3.x) 
00h BYTE search attributes 
Olh BYTE drive letter 
02h 11 BYTEs search template 
-- WILDUNIX.COM 
00h 12BYTEs 15-character wildcard search pattern and drive letter (packed) 
0Ch BYTE search attributes 
~-DOS 2.x and most 3.x 
0Dh WORD entry count within directory 
OFh DWORD _ pointer to DTA 
13h WORD cluster number of start of parent directory 
--PCDOS 4.01, MSDOS 3.2/3,3/5.0 
ODh WORD entry count within directory 
OFh WORD cluster number of start of parent directory 
1th 4BYTEs reserved 
~~-all versions, documented fields 
15h BYTE attribute of file found 
16h WORD file time: 
bits 11-15: hour 
bits 5-10: minute 
bits 0-4: seconds/2 
18h WORD file date: 
bits 9-15: year-1980 


bits 5-8: month 
bits 0-4: day 





i 
i 
\ 
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Table 8-34. Format of FindFirst data block (continued) 


Offset Size Description 
1Ah DWORD file size 
1Eh 13BYTEs ASCIZ filename+extension 


INTERRUPT 21h - Function 4Fh 
“EINDNEXT" - FIND NEXT MATCHING FILE 


Purpose: Locates the next file matching the pathspec which was supplied to a previous invocation of Function 4Eh. 


Available on: DOS 2.0 or higher. Restrictions: Function 4£h (FindFirst) must have been 
executed previously to set up the DTA. 
Registers at call: Return Registers: 
AH = 4Fh CE clear if successful 
[DTA] = data block from previous FindFirst or CF set on error 
FindNext call AX = error code (12h) (see Function 59h) 


Conflicts: None known. 
See Also: Functions 12h and 46h 


INTERRUPT 21h - Function 50h 
SET CURRENT PROCESS ID (SET PSP ADDRESS) 


Purpose: Sets supplied PID value into “current process” variable used by MS-DOS internal code. 


Available on: DOS 2.0 or higher. Restrictions: none. 
Registers at call: Return Registers: n/a 
AH = 50h 


BX = segment of PSP for new process 
Details: DOS uses the current PSP address to determine which processes own files and memory; it corresponds to 
process identifiers used by other operating systems. 

Under DOS 2.x, this function cannot be invoked inside an INT 28h handler without setting the Critical Error 
flag. Under DOS 3+, this function does not use any of the DOS-internal stacks and is thus fully reentrant. 

This call is supported by the OS/2 compatibility box. It is not documented for DOS 2.0 through 4.0x, but has 
been documented for DOS 5.0. 
Conflicts: None known. 
See Also: Functions 26h, 51h, and 62h 


INTERRUPT 21h - Function 51h 
GET CURRENT PROCESS ID (GET PSP ADDRESS) 


Purpose: Reads "current process” variable used by MS-DOS internal code. 


Available on: DOS 2.0 or higher. Restrictions: none. 
Registers at call: Return Registers: 
AH = 5th BX = segment of PSP for current process 


Details: DOS uses the current PSP address to determine which processes own files and memory, it corresponds to 


process identifiers used by other OSs. 
Under DOS 2.x, this function cannot be invoked inside an INT 28h handler without setting the Critical Error 


flag. Under DOS 3+, this function does not use any of the DOS-internal stacks and is thus fully reentrant. : 
‘This call is supported by the OS/2 compatibility box. It is identical to the documented Function 62h, and has 
finally been documented for DOS 5.0. 

Conflicts: None known. 

See Also: Functions 26h, 50h, and 62h 


INTERRUPT 21h - Function 52h 
"SYSVARS" - GET LIST OF LISTS 


Purpose: Obtain pointer to most DOS internal information. 
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Available on: DOS 2.0 or higher. Restrictions: This call is not documented and 
therefore subject to change. 

Registers at call: Return Registers: 

AH=52h ES:BX -> DOS list of lists (Table 8-35) 


Details: The list of lists is partially supported by the OS/2 v1.1+ compatibility box (however, most pointers are 
FFFFh:FFFFh, LASTDRIVE is FFh, and the NUL header "next" pointer is FFFFh:FFFFh), 
Conflicts: "516" virus installation check (chapter 34), 


Table 8-35. Format of List of Lists: 


Offset Size Description 

-12 WORD (DOS 3.1-5.0) sharing retry count (see Function 44h Subfunction OBh) 

-10 WORD (DOS 3.1-5.0) sharing retry delay (see Function 44h Subfunction OBh) 

-8 DWORD (DOS 3.x) pointer to current disk buffer 

-4 WORD (DOS 3.x) pointer in DOS code segment of unread CON input. When CON is read via a 


handle, DOS reads an entire line, and returns the requested portion, buffering the 
rest for the next read. 0000h indicates no unread input 


-2 WORD segment of first memory control block (Tables 8-36 thru 8-38) 
00h DWORD pointer to first Drive Parameter Block (see Function 32h) 
04h DWORD pointer to first System File Table (Tables 8-45 thru 8-48) 
08h DWORD _ pointer to active CLOCK$ device's header 
0Ch DWORD pointer to active CON device's header 
DOS 2.x 
10h BYTE number of logical drives in system 
lth WORD maximum bytes/block of any block device 
13h DWORD _ pointer to first disk buffer (Table 8-52) 
17h 18 BYTEs actual NUL device driver header (not a pointer!), NUL is always the first device on DOS's 
linked list of device drivers. (see Table 8-50 for format) 
DOS 3.0 
10h BYTE number of block devices 
lth WORD maximum bytes/block of any block device 
13h DWORD __ pointer to first disk buffer (Table 8-53) 
17h DWORD _ pointer to array of current directory structures (Table 8-49) 
1Bh BYTE value of LASTDRIVE command in CONFIG.SYS (default 5) 
1Ch DWORD _ pointer to STRING= workspace area 
20h WORD size of STRING area (the x in STRING=x from CONFIG.SYS) 
22h DWORD pointer to FCB table 
26h WORD the y in FCBS=x,y from CONFIG.SYS 
28h 18 BYTEs actual NUL device driver header (not a pointer!). NUL is always the first device on DOS's i 
linked list of device drivers, (see Table 8-50 for format) ; 
--DOS 3.1-3.3 
10h WORD maximum bytes per sector of any block device 
12h DWORD pointer to first disk buffer in buffer chain (Table 8-53) 
16h DWORD _ pointer to array of current directory structures (Table 8-49) 
1Ah DWORD pointer to system FCB tables (see below) 
1Eh WORD number of protected FCBs (the y in the CONFIG.SYS FCBS=x,y) 
20h BYTE number of block devices installed 
2th BYTE number of available drive letters (largest of 5, installed block devices, and 
CONFIG.SYS LASTDRIVE=). Also indicates size of current directory structure 
array. 
22h I8BYTEs actual NUL device driver header (not a pointer!). NUL is always the first device on DOS's 
linked list of device drivers, (see below for format) 
34h BYTE number of JOIN'ed drives 
--DOS 4.x 
10h WORD maximum bytes per sector of any block device 
12h DWORD pointer to disk buffer info record (Tables 8-54 and 8-55) 


16h DWORD pointer to array of current directory structures (Table 8-49) 
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Table 8-35. Format of List of Lists (continued) 


Offset Size Description 

1Ah DWORD pointer to system FCB tables (see below) 

1Eh WORD number of protected FCBs (the y in the CONFIG.SYS FCBS=x,y; always zero for DOS 
5.0) 

20h BYTE number of block devices installed 

21h BYTE number of available drive letters (largest of 5, installed block devices, and CONFIG.SYS 
LASTDRIVES). Also indicates size of current directory structure array. 

22h 18 BYTEs actual NUL device driver header (not a pointer!), NUL is always the first device on DOS's 
linked list of device drivers. (see below for format) 

34h BYTE number of JOIN'ed drives 

35h WORD pointer within IBMDOS code segment to list of special program names (see below; always 
zero for DOS 5,0) 

37h DWORD pointer to FAR routine for resident IFS utility functions (see below). May be called by any 
IFS driver which does not wish to service functions 20h or 24h-28h itself 

3Bh DWORD pointer to chain of IFS (installable file system) drivers 

3Fh WORD the x in BUFFERS x,y (rounded up to multiple of 30 if in EMS) 

4ih WORD the y in BUFFERS x,y 

43h BYTE boot drive (1=A:) 

44h BYTE apparently O1b if 80386+, 00h otherwise 

45h WORD extended memory size in K 

---DOS 5.0 

10h 39 BYTEs as for DOS 4.x (see above) 

37h DWORD pointer to SETVER program list or 0000h:0000h 

3Bh WORD pointer to unknown function in DOS CS 

3Dh WORD apparently 0000h if DOS loaded low, PSP of most-recently EXECed program if DOS in 
HMA 

3Fh 8BYTEs as for DOS 4.x (see above) 


Table 8-36. Format of memory control block (see also Tables 8-37 and 8-38): 


Offset Size Description 

00h BYTE block type: 5Ah if last block in chain, otherwise 4Dh 

Oth WORD PSP segment of owner, 0000h if free, 0008h if belongs to DOS 
03h WORD size of memory block in paragraphs 

05h 3BYTEs unused 

DOS 2.X,3.X 

08h 8BYTEs unused 

--DOS 4+ 

O8h 8BYTEs ASCII program name if PSP memory block, else garbage 


null-terminated if less than 8 characters 
Details: Under DOS 3.1+, the first memory block is the DOS data segment, containing installable drivers, buffers, 
etc. Under DOS 4.x it is divided into subsegments, each with its own memory control block (see below), the first of 
which is at offset 0000h. 
For DOS 5.0, blocks owned by DOS may have either "SC" or "SD" in bytes O8h and 09h. "SC" is system code 
or locked-out inter-UMB memory, "SD" is system data, device drivers, etc, 


Table 8-37. Format of DOS 5.0 UMB control block: 


Offset Size Description 

00h BYTE type: SAh if last block in chain, 4Dh otherwise 

Olh WORD first available paragraph in UMB if control block is at start of UMB, 000Ah if control 
block is at end of UMB. 

03h WORD length in paragraphs of following UMB or locked-out region 

OSh 3BYTEs unused 


08h 8BYTEs block type name: "UMB" if start block, "SM" if end block in UMB. 
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Table 8-38. Format of STARLITE memory control block: 


Offset Size Description 

00h BYTE block type: 5Ah if last block in chain, otherwise 4Dh 

Oth WORD PSP segment of owner, 0000h if free, 0008h if belongs to DOS 
03h WORD size of memory block in paragraphs 

05h BYTE unused 

06h WORD segment address of next memory control block (0000h if Last) 
08h WORD segment address of previous memory control block or 0000h 
OAh 6BYTEs reserved 


Table 8-39. Format of DOS 4.x data segment subsegment control blocks: 


Offset Size Description 
00h BYTE subsegment type (blocks typically appear in this order) 
"D" device driver 
"EB" device driver appendage 
"I" IFS (Installable File System) driver 
"F" FILES= control block storage area (for FILES>5) 
"X" FCBS= control block storage area, if present 
"C" BUFFERS EMS workspace area (if BUFFERS /X option used) 
“B" BUFFERS= storage area 
"L" LASTDRIVES current directory structure array storage area 
"S" STACKS= code and data area, if present (Table 8-40) 


Olh WORD paragraph of subsegment start (usually the next paragraph) 
03h WORD size of subsegment in paragraphs 

05h 3BYTEs unused 

08h 8BYTEs for types "D" and "I", base name of file from which 


the driver was loaded (unused for other types) 


Table 8-40. Format of data at start of STACKS code segment (if, present): 


Offset Size Description 

00h WORD unknown. 

02h WORD number of stacks (the x in STACKS=x,y) 

04h WORD size of stack control block array (should be 8*x) 

06h WORD size of each stack (the y in STACKS=x,y) 

08h DWORD ptr to STACKS data segment 

0Ch WORD offset in STACKS data segment of stack control block array 

OEh WORD offset in STACKS data segment of last element of that array 

10h WORD offset in STACKS data segment of the entry in that array for the next stack to be allocated 


(initially same as value in OEh and works its way down in steps of 8 to the value 
in OCh as hardware interrupts pre-empt each other) 
Details: The STACKS code segment data may, if present, be located as follows: 

DOS 3.2: The code segment data is at a paragraph boundary fairly early in the IBMBIO segment (seen at 
0070:0190h), 

DOS 3.3: The code segment is at a paragraph boundary in the DOS data segment, which may be determined by 
inspecting the segment pointers of the vectors for those of interrupts 02h, O8h-OEh, 70h, 72-77h which have not been 
redirected by device drivers or TSRs. 

DOS 4.x: Identified by sub-segment control block type "S" within the DOS data segment. 


Table 8-41, Format of array elements in STACKS data segment: 


Offset Size Description 
00h BYTE Status: 
00h = free, 
Oth =in use, 


03h = corrupted by overflow of higher stack, 
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Table 8-41. Format of array elements in STACKS data segment (continued) 


Offset Size Description 

Oth BYTE not used 

02h WORD previous SP 

04h WORD previous SS 

06h WORD ptr to word at top of stack (new value for SP). The word at the top of the stack is preset to 


point back to this control block. 


Table 8-42. Format of SHARE.EXE hooks (DOS 3.1-4.01) (offsets from first SFT--pointed at by ListOfLists+04h): 


Offset Size Description 
-3Ch DWORD pointer to unknown FAR routine 
Note: not called by MSDOS 3.3, 
set to 0000h:0000h by SHARE 3.3 
-38h DWORD _ pointer to FAR routine called on opening file 
on call, internal DOS location points at filename (see Function 5Dh Subfunction 06h) 
Return: CF clear if successful 
CF set on error 
AX = DOS error code (24h) (see Function 59h) 
Note: SHARE assumes DS=SS=DOS DS and directly accesses DOS 
internals to get name of file just opened 
~34h DWORD _ pointer to FAR routine called on closing file 
ES:DI -> system file table 
Note: SHARE assumes SS=DOS DS, directly accesses DOS internals. It 
performs an unknown action on every lock record for the file. 
-30h DWORD _ pointer to FAR routine to close all files for given computer 
(called by Function 5Dh Subfunction 03h) 
Note: SHARE assumes SS=DOS DS, directly accesses DOS internals 
-2Ch DWORD _ pointer to FAR routine to close all files for a given 
process (called by Function 5Dh Subfunction 04h) 
Note: SHARE assumes SS=DOS DS, directly accesses DOS internals 
-28h DWORD pointer to FAR routine to close file by name 
(called by Function 5Dh Subfunction 02h) 
DS:SI -> DOS parameter list (see Function 5Dh Subfunction 00h) 
DPL's DS:DX -> name of file to close 
Return: CF clear if successful 
CF set on error 
AX = DOS error code (03h) (see Function 59h) 
Note: SHARE assumes SS=DOS DS, directly accesses DOS internals 
-24h DWORD _ pointer to FAR routine to lock region of file 
call with BX = file handle 
CX:DX = starting offset 
SI:AX = size 
Return: CF set on error 
AL = DOS etror code (21h) (see Function 59h) 
Note: only called if file is marked as remote; SHARE assumes S8S=DOS 
DS, directly accesses DOS internals 
-20h DWORD _ pointer to FAR routine to unlock region of file 
call with BX = file handle 
CX:DX = starting offset 
SI:AX = size 
Return: CF set on error 
AL = DOS error code (21h) (see Function 59h) 
Note: only called if file is marked as remote; SHARE assumes $S=DOS 
DS, directly accesses DOS internals 





\ 
| 
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Table 8-42. Format of SHARE.EXE hooks (DOS 3.1-4.01) (continued) 


Offset Size Description 
-ICh DWORD pointer to FAR routine to check if file region is locked 
call with ES:DI -> system file table entry for file 
CX = length of region from current position in 
file 
Return: CF set if any portion of region locked 
AX =002Ih 
Note: SHARE assumes SS=DOS DS, directly accesses DOS internals 
-18h DWORD pointer to FAR routine to get open file list entry 
(called by Function 5Dh Subfunction 05h) 
call with DS;SI -> DOS parameter list (see Function 5Dh Subfunction 00h) 
DPL's BX = index of sharing record 
DPL's CX = index of SFT in SFT chain of sharing 
rec 
Return: CF set on error or not loaded 
AX = DOS error code (12h) (see Function 59h) 
CF clear if successful 
ES:DI -> filename 
CX = number of locks owned by specified SFT 
BX = network machine number 
DX destroyed 
Note: SHARE assumes SS=DOS DS, directly accesses DOS internals 
-14h DWORD pointer to FAR routine for updating FCB from SFT 
call with DS:SI -> unopened FCB 
ES:DI -> system file table entry 
Return: BL = COh 
Note: copies the following fields from SFT to FCB: 
starting cluster of file: OBh LAh 
sharing record offset: 33h 1Ch 
file attribute: 04h 1Eh 
-10h DWORD pointer to FAR routine to Set first cluster of FCB file 
call with ES:DI -> system file table entry 
DS:SI -> FCB 
Return: CF set if SFT closed or sharing record offsets mismatched 
CF clear if successful 
BX = starting cluster number from FCB 
-0Ch DWORD pointer to FAR routine to close file if duplicate for process 
DS:SI -> system file table 
Return: AX = number of handle in JFT which already uses SFT 
Notes: called during open/create of a file; SHARE assumes SS=DOS 
DS, directly accesses DOS internals. 





If the SFT was opened with inheritance enabled and sharing mode 111, 
does something to all other SFTs owned by same process which have the same 
file open 
mode and sharing record 
-O8h DWORD pointer to unknown FAR routine 
Note: SHARE assumes SS=DS=DOS DS, direct-accesses DOS 
internals; it closes various handles referring to the file most-recently 
opened 
-04h DWORD pointer to FAR routine to update directory info in related SFT entries 
call with ES:DI -> system file table entry for file (see below) 
AX = subfunction (apply to each related SFT) 
00h: update time stamp (offset ODh) and 
date stamp (offset OFh) 
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Table 8-42. Format of SHARE.EXE hooks (DOS 3.1-4.01) (continued) 


Offset 
-40h 


Size Description 
(continued) AX = subfunction 
Oth: update file size (offset 11h) and 
starting cluster (offset OBh). 
Sets last-accessed cluster fields 
to start of file if file never 
accessed 
02h: as function Olh, but last-accessed 
fields always changed 
03h: do both functions 00h and 02h 
Note: follows ptr at offset 2Bh in system file table entries; this call is a 
NOP if the file was opened with no-inherit or via FCB 


Table 8-43, Format of sharing record: 


Offset 
00h 


Oth 
03h 


04h 
06h 
OAh 
0Ch 


Size Description 
BYTE flag: 
00h free block 
OLh allocated block 


FFh end marker 
WORD size of block 
BYTE checksum of pathname (including NUL) 
if sum of ASCII values is N, checksum is (N/256 + N%256) 
WORD offset in SHARE's DS of lock record (see below) 
DWORD _ pointer to start of system file table chain for file 
WORD unique sequence number 
var ASCIZ full pathname 


Table 8-44. Format of SHARE.EXE lock record: 


Offset 
00h 
02h 
06h 
O0Ah 
OEh 


Size Description 

WORD offset in SHARE’s DS of next lock table in list 
DWORD offset in file of start of locked region 
DWORD _ offset in file of end of locked region 

DWORD _ pointer to System File Table entry for this file 
WORD PSP segment of lock's owner 


Table 8-45, Format of DOS 2.x system file tables: 


Offset 
00h 
04h 
06h 


Size Description 

DWORD __ pointer to next file table 
WORD number of files in this table 
28h bytes _ per file in following format: 


Offset Size Description 

00h BYTE number of file handles referring to this file 

Olh BYTE file open mode (see Function 3Dh) 

02h BYTE file attribute 

03h BYTE drive (0 = character device, 1 = A, 2=B, ete) 

04h 11 BYTEs filename in FCB format (no path,no period, blank-padded) 
OFh WORD unknown. 

Vih WORD unknown. 

13h DWORD file size 

17h WORD file date in packed format (see Function 57h Subfunction 00h) 
19h WORD file time in packed format (see Function 57h Subfunction 00h) 


1Bh BYTE device attribute (see Function 44h Subfunction 00h) 
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Table 8-45. Format of DOS 2.x system file tables (continued): 


Offset Size Description 
---character device--- 

1Ch DWORD pointer to device driver 
---block device--- 

1Ch WORD starting cluster of file 

1Eh WORD relative cluster in file of last cluster accessed 
20h WORD absolute cluster number of current cluster 
22h WORD = unknown. 

24h DWORD current file position 


Table 8-46. Format of DOS 3.0 system file tables and FCB tables: 


Offset Size Description 

00h DWORD pointer to next file table 

04h WORD number of files in this table 
Offset Size Description 
00h-1Eh as for DOS 3.1+ (see Table 8-47) 
IFh WORD _ byte offset of directory entry within sector 
2th 11 BYTEs filename in FCB format (no path/period, blank-padded) 
2Ch DWORD (SHARE.EXE) pointer to previous SFT sharing same file 
30h WORD (SHARE.EXE) network machine number 
32h WORD PSP segment of file's owner 
34h WORD (SHARE.EXE) offset in SHARE code seg of share record 
36h WORD apparently always 0000h 


Table 8-47, Format of DOS 3.1-3.3x system file tables and FCB tables: 


Offset Size Description 
00h DWORD pointer to next file table 
04h WORD number of files in this table 
06h 35h bytes _ per file: 
Offset Size Description 
00h WORD number of file handles referring to this file 
02h WORD file open mode (see Function 3Dh); bit 15 set if this file opened via FCB 
04h BYTE file attribute (see Function 43h Subfunction Olh) 
05h WORD device info word (see Function 44h Subfunction 00h) 


bit 15 set if remote file 
bit 14 set means do not set file date/time on closing 


07h DWORD pointer to device driver header if character device, 
else pointer to DOS Drive Parameter Block (see Function 32h) 

OBh WORD | starting cluster of file 

ODh WORD file time in packed format (see Function 57h Subfunction 00h) 

OFh WORD _ file date in packed format (see Function 57h Subfunction 00h) 

1th DWORD file size 

15h DWORD current offset in file (may be larger than size of file; INT 21h Function 42h does 
not check the new position) 

19h WORD relative cluster within file of last cluster accessed 

1Bh WORD absolute cluster number of last cluster accessed, 0000h if file never read or 
written 

IDh WORD number of sector containing directory entry 

1Fh BYTE _ number of dir entry within sector (byte offset/32) 

20h 11 BYTEs filename in FCB format (no path/period, blank-padded) 

2Bh DWORD (SHARE.EXE) pointer to previous SFT sharing same file 

2Fh WORD (SHARE.EXE) network machine number which opened file 


31h WORD PSP segment of file's owner (see Function 26h) 
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Table 8-47. Format of DOS 3.1-3.3x system file tables and FCB tables (continued): 
Offset Size Description | 


| 33h WORD offset within SHARE.EXE code segment of 
i sharing record (see below) 0000h = none { 


| Table 8-48. Format of DOS 4.0-5.0 system file tables and FCB tables: 





/ Offset Size Description | 

/ 00h DWORD pointer to next file table | 

i 04h WORD number of files in this table | 

i OGh 3Bh Bytes per file: 

i 

i Offset Size Description i 
00h WORD number of file handles referring to this file 

\ 02h WORD file open mode (see Function 3Dh) 

\ bit 15 set if this file opened via FCB | 

/ 04h BYTE _ file attribute (see Function 43h Subfunction 01h) i 
05! WORD device info word (see Function 44h Subfunction 00h) | 


bit 15 set if remote file { 
bit 14 set means do not set file date/time on closing 








07h DWORD pointer to device driver header if character device | 
else pointer to DOS Drive Parameter Block (see Function 32h) or REDIR data | 

| OBh WORD _ starting cluster of file | 
i ODh WORD file time in packed format (see Function 57h Subfunction 00h) i 
| OF! WORD file date in packed format (see Function 57h Subfunction 00h) ] 

1h DWORD file size | 
| 15h DWORD current offset in file | 
i -—-ocal file 
| 19h WORD relative cluster within file of last cluster accessed | 
| 1Bh DWORD number of sector containing directory entry 
| 1Fh BYTE number of dir entry within sector (byte offset/32) i 
-~network redirector | 

19h DWORD pointer to REDIRIFS record | 

1Dh 3 BYTEs unknown. 

20h 11 BYTEs filename in FCB format (no path/period, blank-padded) 

2Bh DWORD (SHARE.EXE) pointer to previous SFT sharing same file 

2Fh WORD (SHARE.EXE) network machine number which opened file 

31h WORD PSP segment of file's owner (see Function 26h) 

33h WORD offset within SHARE.EXE code segment of sharing record (see below) 

0000h = none 

35h WORD (local) absolute cluster number of last cluster accessed 
i (redirector) unknown. 
| 37h DWORD pointer to IFS driver for file, 0000000h if native DOS 


i 
Table 8-49, Format of current directory structure (array, 51h bytes [58h for DOS 4.0-5.0] per drive): | 
) 








Offset Size Description / 
00h 67BYTEs ASCIZ path in form X: (local) or MACH (network) 

Note: This is the true path that would be needed if not under SUBST or JOIN. | 
43h WORD drive attributes: 


) bit 15: uses network redirector 

\ 14: physical drive \ 
\ Note: drive invalid if 15/14 = 00, installable file system if 11 

13; JOIN'ed 

12: SUBST'ed 

45h DWORD pointer to Drive Parameter Block for drive (see Function 32h) | 
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Table 8-49. Format of current directory structure (continued): 


Offset Size Description 
--local drives 
49h WORD starting cluster of current directory 
0000h = root, FFFFh = never accessed 
4Bh WORD unknown, seems to be FFFFh always 
4Dh WORD unknown. seems to be FFFFh always 
---network drives 
49h DWORD pointer to redirector or REDIRIFS record, or FEFFh:FEFFh 
4Dh WORD stored user data from INT 21h Function Fh Subfunction 03h 
4Fh WORD offset in current directory path of backslash corresponding to root directory for 


drive. This value specifies how many characters to hide from the 
"CHDIR" and "GETDIR" calls; normally set to 2 to hide the drive letter 
and colon. SUBST, JOIN, and networks change it so that only the 
appropriate portion of the true path is visible to the user. 


~-DOS 4.x 

Sih BYTE unknown. used by network 

52h DWORD pointer to IFS driver for this drive, 00000000h if native DOS 
S6h WORD unknown. 


Table 8-50. Format of device driver header: 


Offset Size Description 
00h DWORD pointer to next driver, offset=FFFFh if last driver 
04h WORD device attributes: 
Character device: 
bit 15 set 


bit 14 IOCTL supported (see Function 44h) 

bit 13 (DOS 3+) output until busy supported 

bit 12 reserved 

bit 11 (DOS 3+) OPEN/CLOSE/RemMedia calls supported 

bits 10-8 reserved 

bit 7 (DOS 5.0) Generic IOCTL Check call supported (command 19h) (see Function 44h 
Subfunction 10h) 

bit 6 (DOS 3.2+) Generic IOCTL call supported (command 13h) (see Function 44h 
Subfunction 0Ch, Function 44h Subfunction 0Dh) 

bit 5 reserved 

bit 4 device is special (supports INT 29h “fast console output") 

bit 3 device is CLOCK$ (all reads/writes use transfer record described below) 

bit 2 device is NUL 

bit 1 device is standard output 

bit 0 device is standard input 

Block device: 

bit 15 clear 

bit 14 IOCTL supported 

bit 13 non-IBM format 

bit 12 reserved 

bit 11 (DOS 3+) OPEN/CLOSE/RemMedia calls supported 

bit 10 reserved 

bit9 direct I/O not allowed (set by DOS 3.3 DRIVER.SYS for "new" drives) 

bit8 unknown, set by DOS 3.3 DRIVER.SYS for "new" drives 

bit 7 (DOS 5.0) Generic IOCTL Check call supported (command [9h) (see Function 44h 
Subfunction 1th) 

bit 6 (DOS 3.2+) Generic IOCTL call supported (command 13h) implies support for 
commands 17h and 18h (see Function 44h Subfunctions OCh-OFh) 
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Table 8-50. Format of device driver header (continued) 


Offset Size 

06h WORD 
08h WORD 
---character device 

OAh 8 BYTEs 
---block device 

OAh BYTE 
OBh 7 BYTEs 
12h WORD 
14h BYTE 
15h BYTE 
16h 6 BYTEs 


Description 
bits 5-2 reserved 
bit | driver supports 32-bit sector addressing 
bitO reserved 
device strategy entry point, call with ES:BX -> request header (see INT 2Fh Function 08h 
Subfunction 02h) 
device interrupt entry point 


blank-padded character device name 


number of subunits (drives) supported by driver 
unused 


(CD-ROM driver) reserved, must be 0000h 

(CD-ROM driver) drive letter (must initially be 00h) 

(CD-ROM driver) number of units 

(CD-ROM driver) signature 'MSCDnn' where ‘nn’ is version (currently '00') 


Table 8-51. Format of CLOCK$ transfer record: 


Offset 
00h 
02h 
03h 
04h 
05h 


Size 
WORD 
BYTE 
BYTE 
BYTE 
BYTE 


Description 

number of days since 1-Jan-1980 
minutes 

hours 

hundredths of second 

seconds 


Table 8-52. Format of DOS 2.x disk buffer: 


Offset 
00h 
04h 
05h 
08h 
OAh 
OBh 
0Ch 
10h 


Size 
DWORD 
BYTE 

3 BYTEs 
WORD 
BYTE 
BYTE 
DWORD 


Description 

pointer to next disk buffer, offset = FFFFh if last least-recently used buffer is first in chain 
drive (O=A, 1=B, etc), FFh if not in use 

unused (seems always to be 00h 00h OLh) 

logical sector number 

number of copies to write (1 for non-FAT sectors) 

sector offset between copies if multiple copies to be written 

pointer to DOS Drive Parameter Block (see Function 32h) 

buffered data 


Table 8-53. Format of DOS 3.x disk buffer: 


Offset 
00h 
04h 
05h 


06h 
08h 
09h 


Size 
DWORD 
BYTE 
BYTE 


WORD 
BYTE 
BYTE 


Description 

pointer to next disk buffer, offset = FFFFh if Jast least-recently used buffer is first in chain 
drive (O=A, 1B, etc), FFh if not in use 

flags: 

bit 7: unknown. 

bit 6: buffer dirty 

bit 5: buffer has been referenced 

bit 4: unknown. 

bit 3: sector in data area 

bit 2: sector in a directory, either root or subdirectory 

bit 1: sector in FAT 

bit 0: boot sector 

logical sector number 

number of copies to write (1 for non-FAT sectors) 

sector offset between copies if multiple copies to be written 
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Table 8-53. Format of DOS 3.x disk buffer (continued) 


Offset Size Description 

OAh DWORD _ pointer to DOS Drive Parameter Block (see Function 32h) 
OEh WORD unused (almost always 0) 

10h buffered data 


Table 8-54, Format of DOS 4.00 (pre UR 25066) disk buffer info: 


Offset Size Description 

00h DWORD pointer to array of disk buffer hash chain heads (Table 8-56) 
04h WORD number of disk buffer hash chains (referred to as NDBCH below) 
06 DWORD _ pointer to lookahead buffer, zero if not present 

OAh WORD number of lookahead sectors, else zero (the y in BUFFERS=x,y) 
0Ch BYTE 00h if buffers in EMS (/X), FFh if not 

0Dh WORD EMS handle for buffers, zero if not in EMS 

OFh WORD EMS physical page number used for buffers (usually 255) 

11 WORD unknown. seems always to be O001h 

13h WORD segment of EMS physical page frame 

15) WORD apparently always zero 

17h 4 WORDs EMS partial page mapping information 


Table 8-55. Format of DOS 4.01 (from UR 25066 Corrective Services Disk on) disk buffer info: 





Offset Size Description 
00 DWORD pointer to array of disk buffer hash chain heads (Table 8-56) 
04h WORD number of disk buffer hash chains (referred to as NDBCH below) 
06h DWORD pointer to lookahead buffer, zero if not present 
OAh WORD number of lookahead sectors, else zero (the y in BUFFERS=x,y) 
0Ch BYTE Oth, possibly to distinguish from pre-UR 25066 format 
ODh WORD EMS segment for BUFFERS (only with /XD) 
OFh WORD EMS physical page number of EMS seg above (only with /XD) 
lth WORD unknown EMS segment (only with /XD) 
13h WORD EMS physical page number of above (only with /XD) 
15h BYTE number of EMS page frames present (only with /XD) 
16h WORD segment of one-sector workspace buffer allocated in main memory if BUFFERS/XS or 
/XD options in effect, possibly to avoid DMA into EMS 
18h WORD EMS handle for buffers, zero if not in EMS 
1Ah WORD EMS physical page number used for buffers 
(usually 255) 
1Ch WORD unknown. appears always to be 0001h 
1Eh WORD segment of EMS physical page frame 
20h WORD unknown. appears always to be zero 
22h BYTE 00h if XS, 01h if (XD, FFh if BUFFERS not in EMS 


Table 8-56. Format of DOS 4.x disk buffer hash chain head (array, one entry per chain): 


Offset Size Description 

00h WORD EMS logical page number in which chain is resident, -1 if not in EMS 

02h DWORD pointer to least recently used buffer header, All buffers on this chain are in the same 
segment. 

06h BYTE number of dirty buffers on this chain 

07h BYTE reserved (00h) 


Details: Buffered disk sectors are assigned to chain N where N is the sector's address modulo NDBCH, 0 <= N <= 
NDBCH-1. Each chain resides completely within one EMS page. This structure is in main memory even if buffers 
are in EMS. 
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Table 8-57. Format of DOS 4.0-5.0 disk buffer: 


Offset 
00h 
02h 
04h 
05h 


06h 
OAh 


OBh 
ODh 
lh 
13h 
14h 


Size 
WORD 
WORD 
BYTE 
BYTE 


DWORD 
BYTE 


WORD 
DWORD 
WORD 
BYTE 


Description 

orward ptr, offset only, to next least recently used buffer 

ackward ptr, offset only 

drive (0=A,1=B, etc), FFh if not in use 

lags: 

bit 7: remote buffer 

bit 6: buffer dirty 

bit 5: buffer has been referenced 

bit 4: search data buffer (only valid if remote buffer) 

bit 3: sector in data area 

bit 2: sector in a directory, either root or subdirectory 

bit 1: sector in FAT 

bit 0: reserved 

logical sector number 

number of copies to write: for FAT sectors, same as number of FATs for data and directory 
sectors, usually 1 

offset in sectors between copies to write for FAT sectors 

pointer to DOS Drive Parameter Block (see Function 32h) 

buffer use count if remote buffer (see flags above) 

reserved 

buffered data 





Details: All buffered sectors which have the same hash value (computed as the sum of high and low words of the 
logical sector number divided by NDBCH) are on the same doubly-linked circular chain; for DOS 5.0, only a single 
chain exists. The links consist of offset addresses only, the segment being the same for all buffers in the chain. 


Table 8-58. Format of DOS 5.0 disk buffer info: 


Offset 
00h 
04h 
06h 
OAh 
0Ch 


ODh 
1h 
14h 
16h 
17h 
18h 
19h 
1Ah 
1Ch 
1Dh 
Fh 


21h 


Size 
DWORD 
WORD 
DWORD 
WORD 
BYTE 


DWORD 
3 BYTEs 
WORD 
BYTE 
BYTE 
BYTE 
BYTE 
WORD 
BYTE 
WORD 
WORD 


WORD 


Description 

pointer to least-recently-used buffer header (may be in HMA) (see above) 

0000h number of disk buffer hash chains (DOS 5 does not hash the buffers) 

pointer to lookahead buffer, zero if not present 

number of lookahead sectors, else zero (the y in BUFFERS=x,y) 

buffer location 

00h base memory, no workspace buffer 

Olh HMA, workspace buffer is in base memory 

pointer to one-segment workspace buffer in base memory 

unknown. 

unknown 

unknown 

unknown 

unknown 

unknown 

unknown 

bit 0 set if UMB memory chain linked to normal MCB chain 

unknown 

segment of first memory control block in upper memory blocks or FFFFh if DOS memory 
chain in base 640K only 

paragraph of start of most recent MCB chain search 


Table 8-59. Format of IFS driver list: 


Offset 
00h 
04h 
0Ch 


Size 

DWORD 
8 BYTEs 
4 BYTEs 


Description 

pointer to next driver header 

IFS driver name (blank padded), as used by FILESYS command 
unknown. 
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Table 8-59. Format of IFS driver list (continued): 


Offset 
10h 


14h 


Size Description 

DWORD pointer to IFS utility function entry point (see Table 8-60) 
call with ES:BX -> IFS request (see Table 8-61) 

WORD offset in header’s segment of driver entry point 
unknown. 


Table 8-60. Use of IFS utility function entry point 
Call IFS utility function entry point with: 


AH = 20h miscellaneous functions 
AL = 00h get date 
Return: CX = year 
DH = month 
DL = day 
AL = Oh get process ID and computer ID 
Return: BX = current PSP segment 
DX = active network machine number 
AL = 05h get file system info 
ES:DI -> 16-byte info buffer 
Return: buffer filled as follows: 


Offset Size Description 
00h 2BYTEs unused 
02h WORD number of SFTs (actually counts only the first two file table arrays) 
04h WORD number of FCB table entries 
06h WORD number of proctected FCBs 
08h 6BYTEs unused 
OEh WORD largest sector size supported 
AL = 06h get machine name 
ES:DI -> 18-byte buffer for name 
Return: buffer filled with name starting at offset 02h 
AL = 08h get sharing retry count 
Return: BX = sharing retry count 
AL = other 
Return: CF set 
AH = 21h get redirection state 
BH = type (03h disk, 04h printer) 
Return: BH = state (00h off, 01h on) 
AH = 22h unknown. some sort of time calculation 
AL = 00h unknown 
nonzero unknown 
AH = 23h appears to be a time calculation 
AH = 24h compare filenames 
DS:SI -> first ASCIZ filename 
ES:DI -> second ASCIZ filename 
Return: ZF set if filenames are same ignoring case 
AH = 25h normalize filename 
DS:SI -> ASCIZ filename 
ES:DI -> buffer for result 
Return: filename uppercased, forward slashes changed to backslashes 
AH = 26h get DOS stack 
Return: DS:SI -> top of stack 
CX = size of stack in bytes 
AH = 27h increment InDOS flag 


Table 8-60. Use of IFS utility function entry point (continued) 
AH = 28h decrement InDOS flag 


Details: IFS drivers which do not wish to implement functions 20h or 24h-28h may pass them on to the default 


handler pointed at by [ListOfLists+37h]. 


Table 8-61. Format of LFS request block: 


Offset Size Description 
00h WORD total size in bytes of request 
02h BYTE class of request: 


02h unknown. 

03h redirection 

04h unknown. 

O5h file access 

06h convert error code to string 

O7h unknown, 
03h WORD returned DOS error code 
05h BYTE IFS driver exit status: 

00h success 

Olh unknown, 

02h unknown, 

03h unknown. 

04h unknown. 

FFh internal failure 


06h 16 BYTEs unknown. 
---request class 02h 
16h BYTE function code 
04h unknown, 
17h BYTE apparently unused 
18h DWORD pointer to unknown. 
1Ch DWORD pointer to unknown. 
20h 2BYTEs unknown. 
--request class 03h 
16h BYTE function code 
17h BYTE unknown. 
18h DWORD pointer to unknown. 
1Ch DWORD _ pointer to unknown. 
22h WORD returned unknown. 
24h WORD returned unknown. 
26h WORD returned unknown, 
28h BYTE returned unknown. 
29h BYTE apparently unused. 
---request class 04h 
16h DWORD pointer to unknown. 
1Ah DWORD pointer to unknown. 
--request class 05h 
16h BYTE function code: 
O1h flush disk buffers 
02h get disk space 
03h MKDIR 
04h RMDIR 
05h CHDIR 
06h delete file 


07h rename file 

O8h search directory 
09h file open/create 
0Ah LSEEK 
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OBh read from file 

0Ch write to file 

ODh lock region of file 
OEh commit/close file 
OFh get/set file attributes 
10h printer control 

11h unknown, 

12h process termination 
13h unknown. 
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Table 8-61. Format of IFS request block (continued) 











Offset Size Description 

-~-class 05h function 01h 

17 7BYTEs unknown. 

1Eh DWORD pointer to unknown. 

22h 4BYTEs unknown. 

26h BYTE unknown, 

27h BYTE unknown, 

---class 05h function 02h 

17h 7BYTEs unknown. 

IEh DWORD pointer to unknown. 

22h 4BYTEs unknown, 

26h WORD returned total clusters 

28h WORD returned sectors per cluster 
2Ah WORD returned bytes per sector 

2Ch WORD returned available clusters 
2Eh BYTE returned unknown, 

2Fh BYTE unknown. 

-~-Class 05h functions 03h,04h,05h 

17h TBYTEs — unknown. 

1Eh DWORD pointer to unknown. 

22h 4BYTEs unknown. 

26h DWORD pointer to directory name 
---Class 05h function 06h 

17h TBYTEs — unknown. 

1Eh DWORD pointer to unknown. 

22h 4BYTEs unknown, 

26h WORD attribute mask 

28h DWORD pointer to filename 

-~¢lass 05h function 07h 

17h TBYTEs unknown. 

1Eh DWORD pointer to unknown. 

22h 4BYTEs unknown. 

26h WORD attribute mask 

28h DWORD pointer to source filespec 
2Ch DWORD __ pointer to destination filespec 
--¢lass 05h function 08h 

17h 7TBYTEs unknown, 

1Eh DWORD pointer to unknown. 

22h 4BYTEs unknown. 

26h BYTE 00h FINDFIRST 

Oth FINDNEXT 

28 DWORD pointer to FindFirst search data + 01h if FINDNEXT 
2Ch WORD search attribute if FINDFIRST 
2E DWORD pointer to filespec if FINDFIRST 
-~class 05h function 09h 

17 TBYTEs — unknown. 

1EI DWORD pointer to unknown. 

22h DWORD pointer to IFS open file structure (see below) 
26h WORD unknown. together, specify open vs. create, whether 
28h WORD unknown. / or not to truncate 
2Ah 4BYTEs unknown. 

2E DWORD pointer to filename 

32 4BYTEs — unknown. 

36h WORD file attributes on call 











returned unknown, 
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Table 8-61. Format of IFS request block (continued) 


Offset Size Description 
38h WORD returned unknown. 
---class 05h function (Ah 
17h 7BYTEs unknown. 
az) DWORD pointer to unknown. 
22 DWORD pointer to IFS open file structure (see below) 


h 
h 
26h BYTE seek type (02h = from end) 
28h DWORD offset on call 

returned new absolute position 


-~class 05h functions OBh,OCh 











17h TBYTEs = unknown, 
1Eh DWORD pointer to unknown. 
22h DWORD pointer to IFS open file structure (see below) 
28h WORD number of bytes to transfer 
returned bytes actually transferred 
2Ah DWORD _ transfer address 
-~-class 05h function 0Dh 
17h TBYTEs — unknown. 
1Eh DWORD pointer to unknown, 
22h DWORD pointer to IFS open file structure (see below) 
26h BYTE file handle 
27h BYTE apparently unused 
28h WORD unknown. 
2Ah WORD unknown, 
2Ch WORD unknown, 
2Eh WORD unknown, 
---class 05h function 0EA 
17h 7 BYTEs unknown. 
1Eh DWORD pointer to unknown. 
22h DWORD pointer to IFS open file structure (see below) 
26h BYTE 00h commit file 
Olh close file 
27h BYTE apparently unused 
~-class 05h function OFh 
17h TBYTEs unknown. 
1Eh DWORD pointer to unknown. 
22h 4BYTEs — unknown. 
26h BYTE 02h GET attributes 
03h PUT attributes 
27h BYTE apparently unused 
28h 12 BYTEs wrtknown. 
34h WORD search attributes 
36 DWORD __ pointer to filename 
3Ah WORD (GET) returned unknown. 
3Ch WORD (GET) returned unknown. 
3H WORD (GET) returned unknown. 
40h WORD (GET) returned unknown. 
42) WORD (PUT) new attributes 


(GET) returned attributes 
-~-Class 05h function 10h 


17h TBYTEs — unknown. 

{Bh DWORD pointer to unknown. 

22h DWORD _ pointer to IFS open file structure (see below) 
26h WORD unknown. 








28h DWORD pointer to unknown. 
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Table 8-61. Format of IFS request block (continued) 


Description 


unknown, 
unknown, 


Offset Size 

---class 05h function 10h (continued) 
2Ch WORD 

2Eh BYTE 

2Fh BYTE 


---class 05h function 11h 








17h 7 BYTEs 
1Eh DWORD 
22h DWORD 
26h BYTE 
27h BYTE 
28h WORD 
2Ah WORD 
2Ch WORD 
2Eh BYTE 
2Fh BYTE 
---class 05h function 12h 
17 15 BYTEs 
26) WORD 
28h BYTE 
29h BYTE 
-~-class 05h function 13h 
17h 15 BYTEs 
26h WORD 
---request class 06h 
16h DWORD 
JAh BYTE 
iBh BYTE 
---request class 07h 
16h DWORD 
1Ah BYTE 
IBh BYTE 


subfunction: 

Olh get printer setup 
03h unknown. 

04h unknown. 

05h unknown, 

06h unknown. 

O7h unknown. 

21h set printer setup 


unknown, 

pointer to unknown, 

pointer to IFS open file structure (see below) 
subfunction 

apparently unused 

unknown. 

unknown, 

unknown. 

unknown, 

unknown, 


apparently unused 

PSP segment 

type of process termination 
apparently unused 


apparently unused 
PSP segment 


returned pointer to string corresponding to error code at 03h 
returned unknown. 
unused 


pointer to IFS open file structure (see below) 
unknown. 
apparently unused 


Table 8-62. Format of IFS open file structure: 


Offset 
00h 
02h 
04h 
06h 
O8h 
OAh 
0Ch 
OEh 
12h 
16h 
18h 
1Ah 


Size 
WORD 
WORD 
WORD 
WORD 
WORD 
WORD 
WORD 
DWORD 
DWORD 
WORD 
WORD 
11 BYTEs 


Description 

unknown, 

device info word 

file open mode 
unknown. 

file attributes 

owner's network machine number 
owner's PSP segment 
file size 

current offset in file 

file time 

file date 

filename in FCB format 





i 
\ 
| 
| 
| 
| 
| 
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Table 8-62. Format of IFS open file structure (continued) 


Offset Size Description 

25 WORD unknown. 

27h WORD hash value of SFT address (low word of linear address + segment&FO00h) 
29h 3 WORDs_ network info from SFT 

2Fh WORD unknown. 


Table 8-63, Format of one item in DOS 4+ list of special program names: 


Offset Size Description 

00h BYTE length of name (00h = end of list) 

Olh NBYTEs name in format name.ext 

N 2BYTES DOS version to return for program (major, minor) (see Function 30h, INT 2Fh Function 
12h Subfunction 2Fh) 

N+2 BYTE (DOS 4.x only) number of times to return fake version number (FFh = always) 


Details: If the name of the executable for the program making the DOS "get version" call matches one of the names 
in this list, DOS returns the specified version rather than the true version number. 


INTERRUPT 21h - Function 53h 
TRANSLATE BIOS PARAMETER BLOCK TO DRIVE PARAMETER BLOCK 


Purpose: Converts drive parameter information from the format stored on disk to that used by DOS routines. 





Available on: DOS 2.0 or higher. Restrictions: This call is not documented and is 
therefore subject to change. 

Registers at call: Return Registers: 

AH =53h ES:BP buffer filled 


DS:SI -> BIOS Parameter Block (Table 8-64) 
ES:BP -> buffer for Drive Parameter Block (see 
Function 32h for format) 
Details: For DOS 3+, the cluster at which to start searching is set to 0000h and the number of free clusters is set to 
FFFFh (not known). 
Conflicts: None known. 


Table 8-64. Format of BIOS Parameter Block: 





Offset Size Description 
00h WORD number of bytes per sector 
02h BYTE number of sectors per cluster 
03h WORD number of reserved sectors at start of disk 
05h BYTE number of FATs 
06h WORD number of entries in root directory 
08h WORD total number of sectors; For DOS 4.0, set to zero if partition >32M, then set DWORD at 
15h to actual number of sectors 

OAh BYTE media ID byte 
OBh WORD number of sectors per FAT 
---DOS 3+ 

Dh WORD number of sectors per track 
OF WORD number of heads 
lth DWORD number of hidden sectors 
15) 11 BYTEs reserved 
DOS 4+ 

Sh DWORD _ total number of sectors if word at 08h contains zero 
19h 6 BYTEs — unknown. 
IF WORD number of cylinders 
21h BYTE device type 
22h WORD device attributes (removable or not, etc) 
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INTERRUPT 21h - Function 54h 


GET VERIFY FLAG 

Purpose: Reads MS-DOS "verify" flag value. 

Available on: DOS 2.0 or higher. Restrictions: none. 
Registers at call: Return Registers: 
AH = 54h AL = verify flag: 


00h off 
Oh on (all disk writes verified after writing) 
Conflicts: None known. 


See Also: Function 2Eh 

INTERRUPT 21h - Function 55h 

CREATE CHILD PSP 

Purpose: Creates PSP for use by child process (obsolete, function now performed by Function 4Bh). 

Available on: DOS 2.0 or higher. Restrictions: This call is not documented and is 
therefore subject to change. 

Registers at call: Return Registers: 

AH = 55h CF clear if successful 


DX = segment at which to create new PSP 
SI = (DOS 3+) value to place in memory size field 
at DX:[0002h] 
Details: Creates a "child" PSP rather than making an exact copy of the current PSP; the new PSP's parent pointer is 
set to the current PSP and the reference count for each inherited file is incremented. The current PSP is set to DX. 
DOS 3+ marks "no inherit" file handles as closed in the child PSP. 
Conflicts: None known. 
See Also: Functions 26h and 50h 


INTERRUPT 21h - Function 56h 


"RENAME" - RENAME FILE 


Purpose: Changes the name of a file as specified; can move a file from one directory to another so long as both are 
on the same logical volume. 


Available on: DOS 2.0 or higher. Restrictions: none. 
Registers at call: Return Registers: 
AH = 56h CF clear if successful 
DS:DX -> ASCIZ filename of existing file (no CF set on error 
wildcards, but see below) AX = error code (02h,03h,05h,1 1h) (see Function 
ES:BX -> ASCIZ new filename (may include path, 59h) 


but not wildcards) 

CL = file attribute mask (server call only, see 

below) 

Details: Renaming does not set the archive attribute (see Function 43h Subfunction 00h), which results in 
incremental backups not backing up the file under its new name. Open files should not be renamed. DOS 3.0 and 
higher allow renaming of directories, but not moving. 

Wildcards are allowed under DOS 3.1+ if this call is invoked via Function 5Dh Subfunction 00h, in which case 
error 12h (no more files) is returned on success, and both source and destination specifications must be canonical (as 
returned by Function 60h); only files matching the specified attribute mask will be renamed. Wildcards in the 
destination are replaced by the corresponding character of each source file being renamed. Under DOS 3.x, the call 
will fail if the destination wildcard is *.* or equivalent. 

Conflicts: None known. 
See Also: Functions 17h and 60h, Function 5Dh Subfunction 00h 


| 
| 
| 
| 
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INTERRUPT 21h - Function 57h, Subfunction 00h 
GET FILE'S DATE AND TIME 
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Purpose: Reads date and time a file was last modified, as contained in the file's directory information. 


Available on: DOS 2.0 or higher. 
Registers at call: 

AX = 5700h 

BX = file handle 


Conflicts: None known. 
See Also: Function 57h Subfunction 01h 


INTERRUPT 21h - Function 57h, Subfunction 01h 
SET FILE'S DATE AND TIME 


Restrictions: none. 
Return Registers: 
CF clear if successful 
CX = file's time: 
bits 15-11: hours (0-23) 
10-5: minutes 
4.0: seconds/2 
DX = file’s date: 
bits 15-9: year - 1980 
8-5; month 
4-0; day 
CF set on error 
AX = error code (01h,06h) (see Function 59h) 


Purpose: Changes file's last-modified date and time information to the specified values. 


Available on: DOS 2.0 or higher. 

Registers at call; 

AX =5701h 

BX = file handle 

CX = new time (see Function 57h Subfunction 00h) 
DX = new date (see Function 57h Subfunction 00h) 
Conflicts: None known, 

See Also: Function 57h Subfunction 00h 


INTERRUPT 21h - Function 57h, Subfunction 02h 
GET unknown value 


Purpose: unknown. 

Available on: DOS 4.x only. 

Registers at call: 

AX = 5702h 

BX = unknown. (0000h through 0004h) 

DS:SI -> unknown. 

ES:DI -> result buffer 

CX = size of result buffer 

Conflicts: None known. 

See Also: Function 57h Subfunctions 03h and 04h 


INTERRUPT 21h - Function 57h, Subfunction 03h 
GET unknown value 


Purpose: unknown, 
Available on: DOS 4.x only. 


Restrictions: none. 
Return Registers: 
CF clear if successful 
CF set on error 
AX = error code (01h,06h) (see Function 59h) 


Restrictions: none. 
Return Registers: 
CX = size of returned data 


Restrictions: none. 
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Registers at call: Return Registers: 
AX = 5703h CX = size of returned data 
BX = file handle (only 0000h through 0004h valid) ES:DI -> zero word (DOS 4.0) if CX >= 2 on entry 


DS:SI -> unknown. passed through to INT 2Fh 
Function 11h Subfunction 2Dh 
ES:DI -> result buffer 
CX & size of result buffer 
Conflicts: None known. 
See Also: Function 57h Subfunctions 02h and 04h, INT 2Fh Function 11h Subfunction 2Dh (chapter 19) 


INTERRUPT 21h - Function 57h, Subfunction 04h 
TRUNCATE OPEN FILE TO ZERO LENGTH 


Purpose: Discard the contents of the file corresponding to one of the five standard file handles (if redirected over the 
network). 


Available on: DOS 4.x only. Restrictions: none. 

Registers at call: Return Registers: 

AX = 5704h CX = size of returned data 

BX = file handle (only 0000h through 0004h valid) ES:DI buffer filled with zero word (DOS 4.0) 
DS:SI -> unknown. passed through to INT 2Fh if CX >= 2 on entry 


Function 11h Subfunction 2Dh 
ES:DI -> result buffer 
CX = size of result buffer 
Conflicts: None known. 
See Also: Function 57h Subfunctions 02h and 03h, INT 2Fh Function 11h Subfunction 2Dh (chapter 19) 


INTERRUPT 21h - Function 58h 
GET OR SET MEMORY ALLOCATION STRATEGY 


Purpose: Read or write memory allocation strategy control byte used by MS-DOS. 


Available on: DOS 3.0 or higher. Restrictions: none. 

Registers at call: Return Registers: 

AH = 58h CF set on error 

AL = subfunction: AX = error code (01h) (see Function 59h) 


CF clear if successful 


00h get allocation strategy AX = current strategy: 

00h low memory first fit 

Olh low memory best fit 

02h low memory last fit 

---DOS 5+ 

40h high memory first fit 

41h high memory best fit 

42h high memory last fit 

80h first fit, try high then low memory 
81h best fit, try high then low memory 
82h last fit, try high then low memory 


O1h set allocation strategy: 
BL = new allocation strategy 
(see above) 
BH = 00h (DOS 5.0) 


02h (DOS 5+) get UMB link state: AL = 00h UMBs not part of DOS memory chain 
= 01h UMBs in DOS memory chain 


03h (DOS 5+) set UMB link state: 
BX = 0000h remove UMBs from 
DOS memory chain 
= 0001h add UMBs to memory chain 
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Details: The Set subfunction accepts any value in BL for DOS 2 through DOS 4.x; a value of 2 or greater means last 


fit. The Get subfunction returns the last value set. 


A program which changes the allocation strategy should restore it before terminating. 


Conflicts: None known. 
See Also: Functions 48h, 49h, and 4Ah 


INTERRUPT 21h - Function 59h 
GET EXTENDED ERROR INFORMATION 


Purpose: Translate and expand on error codes returned by DOS. 
Restrictions: none. 

Return Registers: 

AX = extended error code (Table 8-68) 

BH = error class (Table 8-65) 

BL = recommended action (Table 8-66) 

CH = error locus (Table 8-67) 

CL, DX, SI, DI, BP, DS, and ES destroyed 

Details: Functions available under DOS 2.x map the true DOS 3+ error code into one supported under DOS 2.x. You 
should call this function to retrieve the true error code when an FCB or DOS 2.x call returns an error. 


Available on: DOS 3.0 or higher. 
Registers at call: 

AH = 59h 

BX =0000h 


Conflicts: None known. 


See Also: Function 5Dh Subfunction 0Ah, INT 2Fh Function 12h Subfunction 2Dh 


Table 8-65. Values for Error Class: 


Value Meaning 

Olh out of resource (storage space or I/O 
channels) 

02h temporary situation (file or record lock) 

03h —_ authorization (denied access) 

04h internal (system software bug) 

05h hardware failure 

06h — system failure (configuration file missing or 
incorrect) 


Table 8-66. Values for Suggested Action: 
Value Meaning 

Olh retry 

02h ~— delayed retry 

03h —_ prompt user to reenter input 


Table 8-67. Values for Error Locus: 


Value Meaning 
Olh unknown or not appropriate 
02h block device (disk error) 


Value 
07h 
08h 
09h 
OAh 
OBh 
0Ch 
ODh 


Value 
04h 
05h 
06h 
07h 


Value 
03h 
04h 
05h 


Meaning 

application program error 
not found 

bad format 

locked 

media error 

already exists 

unknown 


Meaning 

abort after cleanup 
immediate abort 

ignore 

retry after user intervention 


Meaning 

network related 

serial device (timeout) 
memory related 
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Table 8-68. Values for extended error code: 


Value Meaning 

00h no error 

Olh — function number invalid 

02h file not found 

03h path not found 

04h — too many open files (no handles available) 
05h access denied 

O0Gh invalid handle 

07h memory control block destroyed 

08h insufficient memory 

09h memory block address invalid 

0Al environment invalid (usually >32K in 
length) 

OBh format invalid 

OCh — access code invalid 

ODh — data invalid 

OEh reserved 

OFh invalid drive 


101 attempted to remove current directory 
il not same device 

12) no more files 

om DOS 3+ 


13hdisk write-protected 

14hunknown unit 

I5hdrive not ready 

16hunknown command 

17hdata error (CRC) 

18hbad request structure length 

19hseek error 

1Ah — unknown media type (non-DOS disk) 

[Bh _ sector not found 

1Ch printer out of paper 

[Dh write fault 

1Eh read fault 

1Fhgeneral failure 

20h sharing violation 

21h lock violation 

22h — disk change invalid; ES:DI -> ASCIZ 

volume label of required disk 

23h = FCB unavailable 

24h sharing buffer overflow 

25h (DOS 4+) code page mismatch 

26h (DOS 4+) cannot complete file operation 
(out of input) 

27h (DOS 4+) insufficient disk space 

28h-31h reserved 


INTERRUPT 21h - Function 5Ah 
CREATE TEMPORARY FILE 





Value Meaning 

32h network request not supported 
33h remote computer not listening 
34h —_ duplicate name on network 

35h network name not found 

361 network busy 

37h network device no longer exists 
38 network BIOS command limit exceeded 
39h _ network adapter hardware error 
3Ah __ incorrect response from network 
3Bh unexpected network error 

3C) incompatible remote adapter 
3Dh print queue full 

3Eh = queue not full 

3Fh not enough space to print file 


40 network name was deleted 

4] network: Access denied 

42) network device type incorrect 
43 network name not found 

44) network name limit exceeded 


45h network BIOS session limit exceeded 

46h temporarily paused 

47h — network request not accepted 

48h network print/disk redirection paused 

49h (LANtastic) invalid network version 

4Ah (LANtastic) account expired. 

4Bh (LANtastic) password expired 

4Ch  (LANtastic) login attempt invalid at this time 

4Dh = (LANtastic v3) disk limit exceeded on 
network node 





4Eh  (LANtastic v3+) not logged in to network node 


4Fh reserved 

50h file exists 

Sth reserved 

52h cannot make directory 

53h fail on INT 24h 

--DOS 3.3+ 

54h too many redirections 
S5hduplicate redirection 

SGhinvalid password 

S7hinvalid parameter 

S8hnetwork write fault 

---DOS 4+ 

59h function not supported on network 
S5Ah required system component not installed 


Purpose: Creates a file with a unique name which must be explicitly deleted. 


Available on: DOS 3.0 or higher. 


Restrictions: none. 
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Registers at call: Return Registers: 
AH =5Ah CF clear if successful 
CX = file attribute (see Function 43h Subfunction AX = file handle opened for read/write in 

O1h) compatibility mode 
DS:DX -> ASCIZ path ending with at least 13 zero DS:DX pathname extended with generated name 

bytes to receive the generated filename for temporary file 

CF set on error 
AX = error code (03h,04h,05h) (Table 8-68) 

Details: COMPAQ DOS 3.31 hangs if the pathname is at XXXXh:0000h; it apparently wraps around to the end of 
the segment. 
Conflicts: None known. 
See Also: Functions 3Ch and SBh 


INTERRUPT 21h - Function 5Bh 
CREATE NEW FILE 
Purpose: Same as Function 3Ch except that this function will fail with an error code if the requested file already 
exists. 
Available on: DOS 3.0 or higher. Restrictions: none. 
Registers at call: Return Registers: 
AH= 5Bh CF clear if successful 
CX = file attribute (see Function 43h Subfunction AX = file handle opened for read/write in 

Olh) compatibility mode 
DS:DX -> ASCIZ filename CF set on error 

AX = error code (03h,04h,05h,50h) (Table 8-68) 

Details: Unlike Function 3Ch, this function will fail if the specified file exists rather than truncating it; this permits 
its use in creating semaphore files because it is an atomic "test and set" operation. 
Conflicts: None known. 
See Also: Function 3Ch, Function 5Ah 


INTERRUPT 21h - Function 5Ch 


"FLOCK" » RECORD LOCKING 


Purpose: Prevent multiple users from accessing the same area of the specified file. 
Available on: DOS 3.0 or higher. Restrictions: SHARE or network must be installed. 


Registers at call: 
AH = 5Ch 
AL = subfunction: 


Return Registers: 
CF clear if successful 
CF set on error 


00h lock region of file AX = error code (01h,06h,21h,24h) (Table 8-68) 
Olh unlock region of file 

BX = file handle 

CX:DX = start offset of region within file 

SI:DI = length of region in bytes 

Details: An unlock call must specify the same region as some prior lock call, Locked regions become entirely 

inaccessible to other processes. Duplicate handles created with Functions 45h or 46h inherit locks, but handles 

inherited by child processes (see Function 4Bh) do not. 

Conflicts: None known. 

See Also: Function 44h Subfunction OBh, INT 2Fh Function {1h Subfunctions OAh and OBh 


INTERRUPT 21h - Function 5Dh, Subfunction 00h 
SERVER FUNCTION CALL 


Purpose: Allows network server to execute DOS calls originating on another machine. 


Available on: DOS 3.1 or higher. Restrictions: This call is not documented and 
therefore subject to change. 
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Registers at call: Return Registers: 
AX = 5D00h As appropriate for function being called. 
DS:DX -> DOS parameter list (Table 8-69); DPL 

contains all register values for a call to 

INT 21h 
Details: This call does not check AH; out of range values will crash the system. Executes using the specified 
computer ID and process ID. Sharing delay loops are skipped, and a special sharing mode is enabled. Wildcards are 
enabled for DELETE (Function 41h) and RENAME (Function 56h), and an extra file attribute parameter is enabled 
for those two functions and OPEN (Function 3Dh). Functions which take filenames require canonical names (as 
returned by Function 60h); this is apparently to prevent multi-hop file forwarding. 
Conflicts: None known. 
See Also: Function 60h 


Table 8-69. Format of DOS parameter list: 


Offset Size Description 

00h WORD AX 

02h WORD BX 

04h WORD Cx 

06h WORD DX 

08h WORD SI 

OAh WORD DI 

0Ch WORD DS 

OEh WORD ES 

10h WORD reserved (0) 

12h WORD computer ID (0 = current system) 
14h WORD process ID (PSP segment on specified computer) 


INTERRUPT 21h - Function 5Dh, Subfunction 01h 
COMMIT ALL FILES FOR SPECIFIED COMPUTER/PROCESS 


Purpose: Flushes buffers and updates directory entries for each file which has been modified; if remote file, calls 
INT 2Fh Function 11h Subfunction 07h. 


Available on: DOS 3.1 or higher. Restrictions: This function is not documented and 
therefore subject to change. 
Registers at call: Return Registers: 
AX = 5D0Ih CF set on error 
DS:DX -> DOS parameter list (Table 8-69), only AX = error code (see Function 59h) 
computer ID and process ID fields used CF clear if successful 


Details: The computer ID and process ID are stored but ignored under DOS 3.3. 
Conflicts: None known. 
See Also: Functions 0Dh and 68h, INT 2Fh Function 11h Subfunction 07h 


INTERRUPT 21h - Function 5Dh, Subfunction 02h 
internal - CLOSE FILE BY NAME 


Purpose: Closes the named file. 
Available on: DOS 3.1 or higher. 
Restrictions: SHARE must be loaded. 


Registers at call: Return Registers: 

AX = 5SD02h CF set on error 

DS:DX -> DOS parameter list (Table 8-69), only AX = error code (see Function 59h) 
fields DX, DS, computer ID, and process ID CF clear if successful 
used 


DPL’s DS:DX -> ASCIZ name of file to close 
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Details: Error unless SHARE is loaded (calls [SysFileTable-28h]) (see Function 52h). Name must be canonical 


fully-qualified, such as returned by Function 60h. 
Conflicts: None known. 


See Also: Function 5Dh Subfunctions 03h and 04h, Functions 3Eh and 60h 


INTERRUPT 21h - Function 5Dh, Subfunction 03h 


internal - CLOSE ALL FILES FOR GIVEN COMPUTER 


Purpose: Closes all files for the specified computer. 
Available on: DOS 3.1 or higher. 


Registers at call: 

AX = 5D03h 

DS:DX -> DOS parameter list (Table 8-69), only 
computer ID used 

Conflicts: None known, 

See Also: Function 5Dh Subfunctions 02h and 04h 


INTERRUPT 21h - Function 5Dh, Subfunction 04h 


internal - CLOSE ALL FILES FOR GIVEN PROCESS 


Restrictions; SHARE must be loaded (calls 
[SysFileTable-30h]). 
Return Registers: 
CF set on error 
AX =error code (see Function 59h) 
CF clear if successful 


Purpose: Close all files currently open for the specified process. 


Available on: DOS 3.1 or higher. 

Registers at call: 

AX = 5D04h 

DS:DX -> DOS parameter list (Table 8-69), only 
computer ID and process ID fields used 

Conflicts: None known. 

See Also: Function 5Dh Subfunctions 02h and 03h 


INTERRUPT 21h - Function 5Dh, Subfunction 05h 


internal - GET OPEN FILE LIST ENTRY 


Restrictions: SHARE must be loaded. 
Return Registers: 
CF set on error 

AX = error code (see Function 59h) 
CF clear if successful 


Purpose: Return the name of an open file, given a system file table index for that file. 


Available on: DOS 3.1 or higher. 

Registers at call: 

AX = 5D05h 

DS:DX -> DOS parameter list (Table 8-69) 

DPL's BX = index of sharing record 

DPL's CX = index of SFT in sharing record's SFT 
list 


Restrictions: SHARE must be loaded. 
Return Registers: 
CF clear if successful 
ES:DI -> ASCIZ filename 
BX = network machine number of SFT's owner 
CX = number of locks held by SFT's owner 
CF set if either index out of range 
AX = 0012h (no more files) 


Details: Names are always canonical fully-qualified, such as returned by Function 60h. 


Conflicts: None known. 
See Also: Functions 5Ch and 60h 


INTERRUPT 21h - Function 5Dh, Subfunction 06h 


GET ADDRESS OF DOS SWAPPABLE DATA AREA 


Purpose: Determine address of swappable data area. 


Available on: DOS 3.0 or higher. 


Restrictions: This function is not documented and 
therefore subject to change. 
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Registers at call: Return Registers: 
AX = 5D06h CF set on error 
AX = error code (see Function 59h) 
CF clear if successful 
DS:SI -> nonreentrant data area, including all three 
DOS stacks (critical error flag is first byte) 
CX = size in bytes of area which must be swapped 
while in DOS 
DX = size in bytes of area which must always be 
swapped 
Details: The Critical Error flag is used in conjunction with the InDOS flag (see Function 34h) to determine when it 
is safe to enter DOS from a TSR. Setting the Critical Error flag allows use of functions 50h/51h from INT 28h under 
DOS 2.x by forcing use of the correct stack, 

Swapping the data area allows reentering DOS unless DOS is in a critical section delimited by INT 2Ah 
Function 80h and INT 2Ah Functions 81h/82h. Under DOS 4.0, Function 5Dh Subfunction OBh should be used 
instead of this function. 

Table 8-70 describes what has been identified in the swappable data areas for DOS 3.10 thru 3.30. 

Conflicts: None known. 
See Also: Function 5Dh Subfunction OBh, INT 2Ah Functions 80h-82h 


Table 8-70. Format of DOS 3.10-3.30 Swappable Data Area: 





Offset Size Description 

00h BYTE critical error flag 

Olh BYTE InDOS flag (count of active INT 21h calls) 

02h BYTE drive on which current critical error occurred, or FFh 

03h BYTE locus of last error 

04h WORD extended error code of last error 

06h BYTE suggested action for last error | 
O7h BYTE class of last error i 
O8h DWORD _ ES:DI pointer for last error ; 
0Ch DWORD _ current DTA 

10h WORD current PSP 

12h WORD stores SP across an INT 23h 

14h WORD return code from last process termination (zeroed after reading with Function 4Dh) 

16h BYTE current drive 

17h BYTE extended break flag 

--remainder need only be swapped if in DOS ' 
18h WORD value of AX on call to INT 21h : 
1Ah WORD PSP segment for sharing/network 

1Ch WORD network machine number for sharing/network (0000h = us) 

1Eh WORD first usable memory block found when allocating memory 

20h WORD best usable memory block found when allocating memory 

22h WORD last usable memory block found when allocating memory 

24 WORD memory size in paragraphs (used only during initialization) 

26) WORD unknown, 

28h BYTE INT 24h returned Fail 

29 BYTE bit flags for allowable actions on INT 24h 

2Ah BYTE unknown flag. 

2Bh BYTE FFh if Ctrl-Break termination, 00h otherwise 

2Ch BYTE unknown flag. 

2Dh BYTE unknown. apparently not referenced by kernel 

2EI BYTE day of month 

2Fh BYTE month 

30h WORD year - 1980 

32h WORD number of days since 1-1-1980 

34h BYTE day of week (0 = Sunday) 





| 
j 
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Table 8-70. Format of DOS 3.10-3.30 Swappable Data Area (continued) 





Size Description 
BYTE working SFT pointer at SDA+2AAh is valid 
BYTE safe to call INT 28h if nonzero 
BYTE flag: if nonzero, INT 24h abort turned into INT 24h fail (set only during process 
termination) 
26 BYTEs device driver request header 
DWORD pointer to device driver entry point (used in calling driver) 
22 BYTEs device driver request header 
22BYTEs device driver request header 
BYTE type of PSP copy: 
60h = simple for INT 21h Function 26h 
FFh = make child 
BYTE unknown. apparently not referenced by kernel 
3BYTEs 24-bit user number (see Function 30h) 
BYTE OEM number (see Function 30h) 
2BYTEs = unknown. 
6BYTEs CLOCK$ transfer record (see Function 52h) 
BYTE apparently buffer for single-byte I/O functions 
BYTE apparently not referenced by kernel 
128 BYTEs buffer for filename 
128 BYTEs buffer for filename 
21 BYTEs findfirst/findnext search data block (see Function 4Eh) 
32 BYTEs directory entry for found file 
81 BYTEs copy of current directory structure for drive being accessed 
11 BYTEs FCB-format filename for device name comparison 
BYTE apparently unused 
11 BYTEs wildcard destination specification for rename (FCB format) 
2BYTEs unknown. 
WORD unknown, 
SBYTEs unknown. 
BYTE extended FCB file attribute 
BYTE type of FCB (00h regular, FFh extended) 
BYTE directory search attributes 
BYTE file open mode 
BYTE unknown flags, bits 0 and 4. 
BYTE unknown flag or counter. 
BYTE unknown flag. 
BYTE flag indicating how DOS function was invoked (00h = direct INT 20h/INT 21h, 
FFh = server call Function 5Dh Subfunction 00h) 
BYTE unknown. 
BYTE unknown flag. 
BYTE flag: 00h if read, O1h if write 
BYTE unknown drive number, 
BYTE unknown. 
BYTE unknown flag or counter. 
BYTE line edit (Function OAh) insert mode flag (nonzero = on) 
BYTE canonicalized filename referred to existing file or directory if FFh 
BYTE unknown flag or counter. 
BYTE type of process termination (00h-03h) (see Function 4Dh) 
BYTE unknown flag. 
BYTE value with which to replace first byte of deleted file's name (normally E5h, but 00h as 
described under INT 21h Function 13h) 
DWORD pointer to Drive Parameter Block for critical error invocation 
DWORD pointer to stack frame containing user registers on INT 21h 
WORD stores SP across INT 24h 
DWORD pointer to unknown DOS Drive Parameter Block 
WORD unknown. 
WORD unknown temporary storage. 
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Table 8-70. Format of DOS 3.10-3.30 Swappable Data Area (continued) 














Offset Size Description 

25E WORD unknown flag. only low byte referenced 

260! WORD unknown temporary storage. 

262h BYTE Media ID byte returned by Functions 1Bh/1Ch 

263 BYTE unknown. apparently not referenced by kernel 

264h DWORD = unknown pointer to device header 

268h DWORD pointer to current SFT 

26Ch DWORD pointer to current directory structure for drive being accessed 

270h DWORD pointer to caller's FCB 

274h WORD number of SFT to which file being opened will refer 

276h WORD temporary storage for file handle 

278h DWORD pointer to a JFT entry in process handle table (see Function 26h) 

27Ch WORD offset in DOS DS of first filename argument 

276! WORD offset in DOS DS of second filename argument 

2801 WORD offset of last component in filename or FFFFh. 

282) WORD unknown offset. 

284h WORD relative cluster within file being accessed 

286h WORD absolute cluster number being accessed 

288h WORD current sector number. 

28Ah WORD current cluster number, 

28C WORD current relative sector number within file. 

28Eh 2BYTEs unknown, 

290h WORD byte offset within current sector. 

292h DWORD _ current offset in file 

296h 6 WORDs = unknown. 

2A2h DWORD _ number of bytes appended to file 

2A6h DWORD pointer to unknown disk buffer 

2AAh DWORD pointer to working SFT 

2AEh WORD used by INT 21h dispatcher to store caller's BX 

2B0h WORD used by INT 21h dispatcher to store caller's DS 

2B2h WORD temporary storage while saving/restoring caller's registers 

2B4h DWORD pointer to previous call frame (offset 250h) if INT 21h reentered; also switched to for 
duration of INT 24h 

2B8h 21 BYTEs FindFirst search data for source file(s) of a rename operation (see Function 4Eh) 

2CDh 32 BYTEs directory entry for file being renamed 

2EDh 331 BYTEs critical error stack (a scratch SFT is located from 403h-437h) 

438h 384 BYTEs disk stack (functions greater than OCh, INT 25h, INT 26h) 

SB8h 384 BYTEs character I/O stack (functions 01h through OCh) 

---DOS 3.2,3.3 only 

738h BYTE device driver lookahead flag (see Function 64h) 

739h BYTE unknown drive number 

73Ah BYTE unknown flag. 

73Ah BYTE unknown, 


INTERRUPT 21h - Function 5Dh, Subfunction 07h 
GET REDIRECTED PRINTER MODE 


Purpose: Gets current printer redirection mode. 
Available on: DOS 3.1 or higher. Restrictions: Network software must be installed. 


Registers at call: 
AX = 5D07h 


Conflicts: None known. 


Return Registers: 
DL = mode: 
00h redirected output is combined 
O1h redirected output in separate print jobs 


See Also: Function SDh Subfunctions 08h and 09h, INT 2Fh Function 11h Subfunction 25h (chapter 19) 
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INTERRUPT 21h - Function 5Dh, Subfunction 08h 
SET REDIRECTED PRINTER MODE 


Purpose: Sets printer redirection mode. 


Available on: DOS 3.1 or higher. Restrictions: Network software must be installed. 
Registers at call: Return Registers: n/a 

AX = 5D08h 

DL = mode: 


00h redirected output is combined 
O1h redirected output placed in separate 
jobs, start new print job now 
Conflicts: None known, 
See Also: Function 5Dh Subfunctions 07h and 09h, INT 2Fh Function 11h Subfunction 25h (chapter 19) 


INTERRUPT 21h - Function 5Dh, Subfunction 09h 
FLUSH REDIRECTED PRINTER OUTPUT 


Purpose: Forces redirected printer output to be printed, and starts a new print job. 


Available on: DOS 3.1 or higher. Restrictions: Network software must be installed. 
Registers at call: Return Registers: n/a 
AX = 5D09h 


Conflicts: None known. 
See Also: Function 5Dh Subfunction 07h, Function 5Dh Subfunction 08h, INT 2Fh Function [1h Subfunction 25h 


(chapter 19) 


INTERRUPT 21h - Function 5Dh, Subfunction 0Ah 
SET EXTENDED ERROR INFORMATION 


Purpose: Modifies extended error information returned by Function 59h. 


Available on: DOS 3.1 or higher. Restrictions: none. 
Registers at call: Return Registers: n/a 
AX = 5DOAh 


DS:DX -> 11-word DOS parameter list (see 

Function 5Dh Subfunction 00h) 
Details: The next call to Function 59h will return values from fields AX, BX, CX, DX, DI, and ES in the 
corresponding registers. This function has been documented for DOS 5.0, but was undocumented in prior versions. 
Conflicts: None known. 
See Also: Function 59h 


INTERRUPT 21h - Function 5Dh, Subfunction 0Bh 
GET DOS SWAPPABLE DATA AREAS 


Purpose: Obtain pointer to list of swappable data areas. 


Available on: DOS 4.x only. Restrictions: This call is undocumented. 
Registers at call: Return Registers: 
AX = 5DOBh CF set on error 


AX = error code (see Function 59h) 
CF clear if successful 
DS:SI -> swappable data area list (Table 8-71) 
Details: Copying and restoring the swappable data areas allows DOS to be reentered unless it is in a critical section 
delimited by calls to INT 2Ah Function 80h and INT 2Ah Functions 81h/82h. 
Conflicts: None known. 
See Also: Function 5Dh Subfunction 06h, INT 2Ah Functions 80h-82h 
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Table 8-71, Format of swappable data area list: 


Offset 
00h 
02h 


Offset 
00h 
04h 


Size 
WORD 
N BYTEs 
Size 
DWORD 
WORD 


Description 
count of data areas 
“count" copies of data area record: 


Description 

address 

length and type: 
bit 15 set if swap always, clear if swap in DOS 
bits 14-0: length in bytes 


Table 8-72. Format of DOS 4.0-5.0 swappable data area: 











Offset Size 

00) BYTE 
Olh BYTE 

02: BYTE 
03h BYTE 

04 WORD 
06h BYTE 
07h BYTE 

08! DWORD 
O0Ch DWORD 
10h WORD 
12h WORD 
14h WORD 
16h BYTE 
17h BYTE 
18h 2 BYTEs 
--remainder need only be si 
1Ah WORD 
1Ch WORD 
1Eh WORD 
20h WORD 
22h WORD 
24h WORD 
26h WORD 
28h WORD 
2Ah 5 BYTEs 
2Fh BYTE 
30h BYTE 
3th BYTE 
32h WORD 
34h WORD 
36h BYTE 
37h 3 BYTEs 
38h 30 BYTEs 
58h DWORD 
5Ch 22 BYTEs 
72) 30 BYTEs 
901 6 BYTEs 
96 6 BYTEs 
9Ch 2 BYTEs 
OE 128 BYTEs 
11Eh 128 BYTEs 
19Eh 21 BYTEs 
1B3h 32 BYTEs 


Description 

critical error flag 

InDOS flag (count of active INT 21h calls) 
drive on which current critical error occurred, or FFh 
locus of last error 

extended error code of last error 

suggested action for last error 

class of last error 

ES:DI pointer for last error 

current DTA 

current PSP 

stores SP across an INT 23h 


return code from last process termination (zerod after reading with Function 4Dh) 


current drive 
extended break flag 
unknown. 


wapped if in DOS 

value of AX on call to INT 2th 

PSP segment for sharing/network 

network machine number for sharing/network (0000h = us) 
first usable memory block found when allocating memory 
best usable memory block found when allocating memory 
last usable memory block found when allocating memory 
memory size in paragraphs (not referenced after initialization) 
unknown, 

unknown, 

unknown. apparently not referenced by kernel 

day of month 

month 

year - 1980 

number of days since 1-1-1980 

day of week (0 = Sunday) 

unknown. 

device driver request header 

pointer to device driver entry point (used in calling driver) 
device driver request header 

device driver request header 

unknown. 

CLOCKS transfer record (see Function 52h) 

unknown, 

buffer for filename 

buffer for filename 

findfirst/findnext search data block (see Function 4Eh) 
directory entry for found file 
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Table 8-72. Format of DOS 4.0-5.0 swappable data area (continued) 


Offset 
1D3h 
22Bh 
236h 














Size 

88 BYTEs 
1 BYTEs 
BYTE 

11 BYTEs 
2 BYTEs 
WORD 

5 BYTEs 
BYTE 
BYTE 
BYTE 
BYTE 
BYTE 
BYTE 
BYTE 
BYTE 





7 BYTEs 
BYTE 
BYTE 
BYTE 
3 BYTEs 
DWORD 
DWORD 
WORD 
DWORD 
WORD 
4 WORDs 
BYTE 
BYTE 
DWORD 
DWORD 
DWORD 
DWORD 
WORD 
WORD 
DWORD 
WORD 
WORD 

6 WORDs 
WORD 
DWORD 
DWORD 
WORD 
DWORD 
WORD 
WORD 
WORD 
3 WORDs 
DWORD 
DWORD 
DWORD 
WORD 
WORD 
WORD 
DWORD 











WORD 


Description 

copy of current directory structure for drive being accessed 

FCB-format filename for device name comparison 

unknown. 

wildcard destination specification for rename (FCB format) 

unknown. 

unknown. 

unknown. 

extended FCB file attributes 

type of FCB (00h regular, FFh extended) 

attribute mask for directory search 

file open attribute 

unknown flag bits. 

unknown flag or counter. 

unknown, 

flag indicating how DOS function was invoked: (00h = direct INT 20h/INT 21h, FFh = 
server call Function 5Dh Subfunction 00h) 

unknown, 

canonicalized filename referred to existing file or directory if FFh 

unknown, 

type of process termination (OOh-03h) 

unknown, 

pointer to Drive Parameter Block for critical error invocation 

pointer to stack frame containing user registers on INT 21h 

apparently stores SP 

pointer to wknown DOS Drive Parameter Block 

segment of disk buffer 

unknown. 

Media ID byte returned by Functions 1Bh/1Ch 

unknown. (apparently not referenced by kernel) 

pointer to unknown. 

pointer to current SFT 

pointer to current directory structure for drive being accessed 

pointer to caller's FCB 

number of SFT to which file being opened will refer 

temporary storage for file handle 

pointer to a JFT entry in process handle table (see Function 26h) 

offset in DOS DS of first filename argument 

offset in DOS DS of second filename argument 

unknown. 

unknown. Possibly directory cluster number 

unknown, 

unknown, 

unknown. 

offset in file 

unknown, 

bytes in partial sector 

number of sectors 

unknown. 

number of bytes appended to file 

pointer to unknown disk buffer 

pointer to unknown SFT 

used by INT 21h dispatcher to store caller's BX 

used by INT 21h dispatcher to store caller's DS 

temporary storage while saving/restoring caller's registers 

pointer to previous call frame (offset 264h) if INT 21h reentered; also switched to for 
duration of INT 24h 

open mode/action for INT 21h Function 6Ch 
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Table 8-72. Format of DOS 4.0-5.0 swappable data area (continued) 








Offset Size Description 

2D6h BYTE unknown. (set to 00h by INT 21h dispatcher, 02h when a read is performed, and O1h or 03h 
by INT 21h Function 6Ch) 

2D7h WORD unknown. 

2D9h DWORD - stored ES:DI for INT 21h Function 6Ch 

2DDh WORD extended file open action code (see Function 6Ch Subfunction 00h) 

2DFh WORD extended file open attributes (see Function 6Ch Subfunction 00h) 

2E1 WORD extended file open file mode (see Function 6Ch Subfunction 00h) 

2E3h DWORD pointer to name of file to open (see Function 6Ch Subfunction 00h) 

2E7h 2WORDs unknown. 

2EBh BYTE unknown, 

2ECh WORD stores DS during call to IFS utility functions at [List-of-Lists + 37h] 

2EEh WORD unknown, 

2F0h BYTE unknown. 

2F1 WORD unknown bit flags. 

2F3 DWORD pointer to user-supplied filename 

2F7h DWORD pointer to unknown. 

2FBh WORD stores SS during call to [List-of-Lists + 37h] 

2FDh WORD stores SP during call to [List-of-Lists + 37h] 

2FFh BYTE flag, nonzero if stack switched in calling [List-of-Lists+37h] 

300h 21 BYTEs FindFirst search data for source file(s) of a rename operation (see Function 4Eh) 

315) 32 BYTEs directory entry for file being renamed 

335h 331 BYTEs critical error stack 

480h 384 BYTEs disk stack (functions greater than OCh, INT 25h, INT 26h) 

600h 384 BYTEs character I/O stack (functions 01h through 0Ch) 

780h BYTE device driver lookahead flag (see Function 64h) 

781h BYTE unknown drive number 

782! BYTE unknown flag. 

783h BYTE unknown, 

784h WORD unknown. 

786) WORD unknown, 

788h WORD unknown, 

78Ah WORD unknown. 

INTERRUPT 2th - Function 5Eh, Subfunction 00h 

GET MACHINE NAME 

Purpose: Determine machine name used by network software. 

Available on: DOS 3.1 or higher. Restrictions: Result is only meaningful if network is 

installed. 

Registers at call: Return Registers: 

AX = 5E00h CF clear if successful 

DS:DX -> 16-byte buffer for ASCIZ machine name CH = validity 


00h name invalid 
nonzero valid 
CL = NetBIOS number for machine name 
DS:DX buffer filled with blank-paded name 
CF set on error 
AX = error code (01h) (see Function 59h) 
Details: Supported by OS/2 v1.3+ compatibility box. 
Conflicts: None known. 
See Also: Function SEh Subfunction 01h 


INTERRUPT 21h - Function 5Eh, Subfunction 01h 
SET MACHINE NAME 


Purpose: Establish machine name used by network software. 


| 
} 
\ 
} 
i 
| 
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Available on: DOS 3.1 or higher. Restrictions: The specified name is only meaningful if 
network is installed. 

Registers at call: Return Registers: n/a 

AX = SEOth 


CH = 00h undefine name (make it invalid) 
nonzero define name 

CL = name number 

DS:DX -> 15-character blank-padded ASCIZ 
name 

Conflicts; None known. 

See Also: Function 5Eh Subfunction 00h 


INTERRUPT 21h - Function SEh, Subfunction 02h 
SET NETWORK PRINTER SETUP STRING 


Purpose: Establish the printer setup string to be used by the network printer. 


Available on: DOS 3.1 or higher. Restrictions; Network software must be installed. 
Registers at call: Return Registers: 
AX = SEO2h CF clear if successful 
BX = redirection list index (see Function 5Fh CF set on error 
Subfunction 02h) AX = error code (01h) (see Function 59h) 


CX = length of setup string 

DS:SI -> setup string 

Conflicts: None known. 

See Also: Function 5Eh Subfunction 03h, INT 2Fh Function 11h Subfunction 1Fh (chapter 19) 


INTERRUPT 21h - Function 5Eh, Subfunction 03h 
GET NETWORK PRINTER SETUP STRING 


Purpose: Read printer setup string used by network printer. 


Available on: DOS 3.1 or higher. Restrictions: Network software must be installed. 
Registers at call: Return Registers: 
AX = 5E03h CF clear if successful 
BX = redirection list index (see Function SFh CX = length of setup string 
Subfunction 02h) ES:DI buffer filled 
ES:DI -> 64-byte buffer for setup string CF set on error 


AX = error code (01h) (see Function 59h) 


Conflicts: None known. 
See Also: Function 5Eh Subfunction 02h, INT 2Fh Function 11h Subfunction [Fh (chapter 19) 


INTERRUPT 21h - Function 5Eh, Subfunction 04h 


SET PRINTER MODE 

Purpose: Specify whether the network printer should operation in text or binary mode. 

Available on: DOS 3.1 or higher. Restrictions; Network software must be installed, 

Registers at call: Return Registers: 

AX = 5E04h CF set on error 

BX = redirection list index (see Function 5Fh AX = error code (see Function 59h) 
Subfunction 02h) CF clear if successful 

DX = mode: 


bit 0: set if binary, clear if text (tabs 
expanded to blanks) 
Details: Calls INT 2Fh Function 11h Subfunction {Fh with 5E04h on stack. 
Conflicts: None known. 
See Also: Function 5Eh Subfunction 05h, INT 2Fh Function {1h Subfunction 1Fh (chapter 19) 
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INTERRUPT 21h - Function 5Eh, Subfunction 05h 


GET PRINTER MODE 
Purpose: Read current printer mode. 
Available on: DOS 3.1 or higher. Restrictions: Network software must be installed. 
Registers at call: Return Registers: 
AX = SEOSh CF set on error 
BX = redirection list index (see Function 5Fh AX = error code (see Function 59h) 
Subfunction 02h) CF clear if successful 
DX = printer mode (see Function SEh 
Subfunction 04h) 


Details: Calls INT 2Fh Function 11h Subfunction [Fh with SEO5h on stack. 
Conflicts: None known. 
See Also: Function 5Eh Subfunction 04h, INT 2Fh Function 11h Subfunction 1Fh (chapter 19) 


INTERRUPT 21h - Function 5Fh, Subfunction 00h 


GET REDIRECTION MODE 
Purpose: Determine current redirection mode (printer/disk). 
Available on: DOS 3.1 or higher. Restrictions: Network software must be installed. 
Registers at call: Return Registers: 
AX = 5F00h CF set on error 
BL = redirection type: AX = error code (see Function 59h) 
03h printer CF clear if successful 
04h disk drive BH = redirection state (00h off, 01h on) 


Conflicts: None known. 
See Also: Function 5Fh Subfunction 01h 


INTERRUPT 21h - Function 5Fh, Subfunction 01h 


SET REDIRECTION MODE 
Purpose: Set current redirection mode (printer/disk). 
Available on: DOS 3.1 or higher. Restrictions: Network software must be installed. 
Registers at call: Return Registers: 
AX = 5FO0Ih CF set on error 
BL = redirection type: AX = error code (see Function 59h) 
03h printer CF clear if successful 
04h disk drive 


BH = redirection state (00h off, 01h on) 

Details: When redirection is off, the local device (if any) rather than the remote device is used. 
Conflicts: None known. 

See Also: Function 5Fh Subfunction 00h, INT 2Fh Function 11h Subfunction 1Eh (chapter 19) 


INTERRUPT 21h - Function 5Fh, Subfunction 02h 
GET REDIRECTION LIST ENTRY 


Purpose: Obtain redirection list entry for specified device. 


Available on: DOS 3.1 or higher. Restrictions: Network software (MS Networks, 
Banyan VINES) must be installed, 
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Registers at call: Return Registers: 

AX = 5F02h CF clear if successful 

BX = redirection list index BH = device status (00h valid, 01h invalid) 

DS:SI -> 16-byte buffer for ASCIZ device name BL = device type (03h printer, 04h disk drive) 
ES:DI -> 128-byte buffer for ASCIZ network name CX = user data previously set by Subfunction 03h 


DS:SI and ES:DI buffers filled 
DX,BP destroyed 
CF set on error 
AX = error code (01h,12h) (see Function 59h) 
Details: This function is passed through to INT 2Fh Function 11h Subfunction 1Eh. Error code 12h is returned if BX 
is greater than the size of the list. 


Conflicts: None known. 
See Also: Function 5Fh Subfunction 03h, INT 2Fh Function {1h Subfunction 1h (chapter 19) 


INTERRUPT 21h - Function 5Fh, Subfunction 03h 


REDIRECT DEVICE 

Purpose: Cause specified device to be redirected to specified network name, 

Available on: DOS 3.1 or higher. Restrictions; Network software (MS Networks, 
Banyan VINES) must be installed. 

Registers at call: Return Registers: 

AX = 5F03h CF clear if successful 

BL = device type (03h printer, 04h disk drive) CF set on error 

CX = user data to save AX = error code (01h,03h,05h,08h,0Fh, 12h) (see 

DS:SI -> ASCIZ local device name (16 bytes max) Function 59h) 


ES:DI -> ASCIZ network name + ASCIZ password 

(128 bytes max total) 
Details: If the device type is disk drive, DS:SI must point at either a null string or a string consisting of the drive 
letter followed by a colon; if a null string, the network attempts to access the destination without redirecting a local 
drive. 
Conflicts: None known. 
See Also: Function SFh Subfunction 02h, Function 5Fh Subfunction 04h, INT 2Fh Function 1h Subfunction 1Eh 
(chapter 19) 


INTERRUPT 21h - Function 5Fh, Subfunction 04h 


CANCEL REDIRECTION 
Purpose: Cancel redirection for the specified device. 
Available on: DOS 3.1 or higher. Restrictions; Network software (MS Networks, 
Banyan VINES) must be installed. 
Registers at call: Return Registers: 
AX = 5F04h CF clear if successful 
DS:SI -> ASCIZ device name or path CF set on error 
AX = error code (01h,03h,05h,08h,OFh, 12h) (see 
Function 59h) 


Details: The DS:SI string must be either a local device name, a drive letter followed by a colon, or a network 
directory beginning with two backslashes. 

Conflicts: None known. 

See Also: Function 5Fh Subfunction 03h, INT 2Fh Function 11h Subfunction 1h 


INTERRUPT 21h - Function 5Fh, Subfunction 05h 

GET REDIRECTION LIST EXTENDED ENTRY 

Purpose: Obtain the redirection list entry for the specified device. 

Available on: DOS 4.0 or higher. Restrictions: Network software (i.e. MS Networks) 
must be installed. 


| 
| 
| 
| 
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Registers at call: Return Registers: 

AX = 5F05h CF clear if successful 

BX = redirection list index BH = device status flag (bit 0 clear if valid) 
DS:SI -> buffer for ASCIZ source device name BL = device type (03h if printer, 04h if drive) 
ES:DI -> buffer for destination ASCIZ network path CX = stored parameter value (user data) 


BP = NETBIOS local session number 

DS:SI buffer filled 

ES:DI buffer filled 

CF set on error 

AX = error code (see Function 59h) 
Details: The local session number allows sharing the redirector's session number; however, if an error is caused on 
the NETBIOS LSN, the redirector may be unable to correctly recover from errors. 
Conflicts: STARLITE architecture. 
See Also: Function SFh Subfunction 06h, Network redirector INT 2Fh Function 11h Subfunction 1Eh (chapter 19) 


INTERRUPT 21h - Function 5Fh, Subfunction 06h 


GET REDIRECTION LIST 

Purpose: Appears to be similar to subfunctions 02h and 05h. 

Available on: DOS 4.0 or higher. Restrictions: Network software (i.e. MS Networks) 
must be installed. 

Registers at call: Return Registers: unknown. 

AX = SFO6h 

other unknown, 

Conflicts: STARLITE architecture. 

See Also: Function 5Fh Subfunctions 02h and 05h 

INTERRUPT 21h - Function 5Fh, Subfunction 07h 

ENABLE DRIVE 

Purpose: Make a logical drive valid after previously disabling it. 

Available on: DOS 5.0. Restrictions: none. 

Registers at call: Return Registers: 

AX = SFO7h CF clear if successful 

DL = drive number (0=A:) CF set on error 


AX = error code (OFh) (see Function 59h) 
Details: This function merely sets the "valid" bit in the current directory structure for the specified drive. 
Conflicts: STARLITE architecture. 
See Also: Function SFh Subfunction 08h 


INTERRUPT 21h - Function 5Fh, Subfunction 08h 


DISABLE DRIVE 

Purpose: Temporarily make a logical drive invalid. 

Available on: DOS 5.0. Restrictions: none. 
Registers at call: Return Registers: 
AX = 5F08h CF clear if successful 
DL = drive number (0=A:) CF set on error 


AX = error code (OFh) (see Function 59h) 
Details: This function merely clears the "valid" bit in the current directory structure for the specified drive. 
Conflicts: STARLITE architecture. 
See Also: Function 5Fh Subfunction 07h 


INTERRUPT 21h - Function 60h 
CANONICALIZE FILENAME OR PATH 


Purpose: Translate the specified pathname to canonical form. 


‘ 
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Available on: DOS 3.0 or higher. Restrictions: none. 
Registers at call: Return Registers: 
AH = 60h CF set on error 
DS:SI -> ASCIZ filename or path AX = error code: 


02h invalid component in directory path or 
drive letter only 
03h malformed path or invalid drive letter 

ES:DI buffer unchanged 
CF clear if successful 

AH = 00h 

AL = destroyed (00h or 5Ch or last character of 

current directory on drive) 

buffer filled with qualified name of the form 

D:.EXT or \MACHINE.EXT 
Details: The input path need not actually exist. Letters are uppercased, forward slashes converted to backslashes, 
asterisks converted to the appropriate number of question marks, and file and directory names are truncated to 8.3 if 
necessary. '.' and '..' in the path are resolved. Filespecs on local drives always start with “d:", those on network drives 
always start with 'V'. 

If the path string is on a JOINed drive, the returned name is the one that would be needed if the drive were not 
JOINed; similarly for a SUBSTed, ASSIGNed, or network drive letter, For this reason, it is possible to get a 
qualified name that is not legal under the current combination of SUBSTs, ASSIGNs, JOINs, and network 
redirections. 

Functions which take pathnames require canonical paths if invoked via INT 21h Function SDh Subfunction 00h. 
This function is used to form the full pathname of an invoked program which is stored after the end of its 
environment. 

This function is supported by the OS/2 v1.1 compatibility box. 

For DOS 3.3, the input and output buffers may be the same, as the canonicalized name is built in an internal 
buffer and copied to the specified output buffer as the very last step 

Under DOS 3.3 to 5.0, a device name is translated differently if the device name does not have an explicit 
directory or the directory is \DEV\ (relative directory DEV from the root directory works correctly). In these cases, 
the returned string consists of the unchanged device name and extension appended to the string X:/ (forward slash 
instead of backward slash as in all other cases) where X is the default or explicit drive letter, 

The input and output buffers may be the same, as this function uses an internal buffer and does not modify the 
output buffer until after completing the canonicalization, at which time it copies the result into the output buffer, 
Conflicts: None known. 

See Also: INT 2Fh Function 11h Subfunction 23h, INT 2Fh Function 12h Subfunction 21h 


INTERRUPT 21h - Function 61h 


ES:DI -> 128-byte buffer for canonicalized name 





UNUSED FUNCTION 

Purpose: None, 

Available on: DOS 3.0 or higher. Restrictions: none. 
Registers at call: Return Registers: 
AH = 6th AL = 00h 


Details: This function does nothing and returns immediately. 
Conflicts: None known. 


INTERRUPT 21h - Function 62h 


GET CURRENT PSP ADDRESS 

Purpose: Get “current process" identifier from MS-DOS. 

Available on: DOS 3.0 or higher, Restrictions: none. 
Registers at call: Return Registers: 


AH = 62h BX = segment of PSP for current process 


| 
i 
| 
} 
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Details: Under DOS 3+, this function does not use any of the DOS-internal stacks and is thus fully reentrant. The 
current PSP is not necessarily the caller's PSP, Identical to the undocumented Function 51h. 

Conflicts: None known. 

See Also: Functions 50h and 51h 


INTERRUPT 21h - Function 63h, Subfunction 00h 
GET LEAD BYTE TABLE ADDRESS 


Purpose: Get address of lead byte table, Applies only to extended (2-byte) character sets. 


Available on: DOS 2.25 only. Restrictions: none. 
Registers at call: Return Registers: 
AX = 6300h CF clear if successful 


DS:SI -> lead byte table (Table 8-73) 
CF set on error 
AX = error code (01h) (see Function 59h) 
Details: Does not preserve any registers other than SS:SP. The US version of MSDOS 3.30 treats this as an unused 
function, setting AL=00h and returning immediately. 
Conflicts: Asian DOS 3.2+. 
See Also: Function 63h Subfunction 01h, Function 07h, Function 08h, Function OBh 


Table 8-73. Format of lead byte table entry: 


Offset Size Description 

00h 2BYTEs — low/high ends of a range of leading byte of double-byte chars 
02h 2BYTEs _ low/high ends of a range of leading byte of double-byte chars 
N 2BYTEs  00h,00h end flag 


INTERRUPT 21h - Function 63h, Subfunction 00h 
GET DOUBLE BYTE CHARACTER SET LEAD TABLE 


Purpose: Get address of lead byte table. Applies only to extended (2-byte) character sets. 


Available on: Asian DOS 3.2 or higher only. Restrictions: none. 
Registers at call: Return Registers: 
AX = 6300h AL = error code: 


00h successful 
DS:SI -> DBCS table (Table 8-74) 
all other registers except CS:IP and SS:SP 
destroyed 
FFh not supported 
Details: Probably identical to DOS 2.25 Function 63h Subfunction 00h. The US version of MSDOS 3.30 treats this 
as an unused function, setting AL=00h and returning immediately. The US version of DOS 4.0+ accepts this 
function, but returns an empty list. 
Conflicts: DOS 2.25. 
See Also: DOS 2.25 Function 63h Subfunction 00h 


Table 8-74, Format of DBCS table: 


Offset Size Description 
00h 2BYTEs _ low/high ends of a range of leading byte of double-byte chars 
02h 2BYTEs — low/high ends of a range of leading byte of double-byte chars 


N 2BYTEs 00h,00h end flag 
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INTERRUPT 2th - Function 63h, Subfunction 01h 
SET KOREAN (HONGEUL) INPUT MODE 


Purpose: Establishes Hongeul input mode, which determines whether partially-formed double-byte characters may 
be read. 


Available on: DOS 2.25 and Asian DOS 3.2 or Restrictions: none. 
higher only. 
Registers at call: Return Registers: 
AX = 6301h AL = status: 
DL = new mode: 00h successful 
00h return only full characters on DOS FFh invalid mode 


keyboard input functions 
Oth return partially-formed characters 
also 
Conflicts: None known. 
See Also: Functions 07h, 08h, OBh, and 63h, Function 63h Subfunction 02h 


INTERRUPT 21h - Function 63h, Subfunction 02h 
GET KOREAN (HONGEUL) INPUT MODE 


Purpose: Determine whether Hongeul input mode is active. 


Available on: DOS 2.25 and Asian DOS 3.2 or Restrictions: none. 
higher only. 

Registers at call: Return Registers: 

AX = 6302h AL = status: 


00h successful 
DL = current input mode: 
00h return only full characters 
OLh return partial characters 
FFh not supported 
Conflicts: None known, 
See Also: Functions 07h, 08h, OBh, and 63h, Function 63h Subfunction 01h 


INTERRUPT 21h - Function 64h 
SET DEVICE DRIVER LOOKAHEAD FLAG 


Purpose: Determine whether DOS should check for the availability of input prior to requesting input on console 


input functions, 

Available on: DOS 3.2 or higher. Restrictions: This call is not documented and 
therefore subject to change. 

Registers at call: Return Registers: n/a 

AH = 64h 


AL = lookahead flag: 
00h (default) call device driver function 5 
(non-destructive read) before 
Functions 01h, 08h, and OAh 
nonzero don't call driver function 5 
Details: Called by DOS 3.3+ PRINT.COM. This function does not use any of the DOS-internal stacks and is thus 
fully reentrant, 
Conflicts: None known. 
See Also: Functions 01h, 08h, and OAh 


INTERRUPT 21h - Function 65h, Subfunctions 01-07h 
GET EXTENDED COUNTRY INFORMATION 


Purpose: Obtain extended country-dependent information. 
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Available on: DOS 3.3 or higher. Restrictions: none. 

Registers at call: Return Registers: 

AH = 65h CF set on error 

AL = info ID: AX = error code (see Function 59h) 
Olh get general internationalization info CF clear if succesful 
02h get pointer to uppercase table CX = size of country information returned 
04h get pointer to filename uppercase table ES:DI -> country information (Table 8-75) 


05h (DOS 3.3+) get pointer to filename 
terminator table 
06h get pointer to collating sequence table 
07h (DOS 4+) get pointer to Double-Byte 
Character Set table 
BX = code page (-1=global code page) 
DX = country ID (-1=current country) 
ES:DI -> country information buffer (see below) 
CX = size of buffer (>= 5) 
Details: Subfunction 05h appears to return the same information for all countries and codepages; it was 
undocumented in DOS 3,3 through 4.x, but has been partially documented for DOS 5.0. NUSFUNC must be installed 
to get information for countries other than the default. 
Conflicts: None known. 
See Also: Function 38h, INT 2Fh Function 14h Subfunctions 01h and 02h 


Table 8-75. Format of country information: 


Offset Size Description 

00h BYTE info ID 

---if info ID = Oth 

Olh WORD size 

03h WORD country ID 

05h WORD code page 

07h 34 BYTEs country-dependent info (see Function 38h) 

--lf info ID = 02h ' 
Olh DWORD pointer to uppercase table (see Table 8-76) ; 
---if info ID = 04h 
Olh DWORD pointer to filename uppercase table (see Table 8-79) i 
--if info ID = 05h 

Olh DWORD pointer to filename character table (see Table 8-78) 

--if info ID = 06h 

Olh DWORD pointer to collating table (see Table 8-77) 

---if info ID = 07h (DOS 4.x) 

Olh DWORD pointer to DBCS lead byte table (see Table 8-80) 


Table 8-76. Format of uppercase table: 


Offset Size Description 
00h WORD table size 
02h 128 BYTEs uppercase equivalents (if any) of chars 80h to FFh 


Table 8-77. Format of collating table: 


Offset Size Description 
00h WORD table size 
02h 256 BYTEs values used to sort characters 00h to FFh 


MS-DOS and Compatibles 8-87 


Table 8-78. Format of filename terminator table: 


Offset Size Description 

00: WORD table size 

02) BYTE unknown (01h for MSDOS 3.30-5.00) 

03) BYTE lowest permissible character value for filename 
04h BYTE highest permissible character value for filename 
05h BYTE unknown (00h for MSDOS 3.30-5.00) 

06h BYTE first excluded character in illegal range 

O7h BYTE last excluded character in illegal range 

08: BYTE unknown (02h for MSDOS 3,30-5.00) 

09 BYTE length of filename terminator list 

OAh NBYTEs characters which terminate a filename: ."/]:l<>+5;, 


Table 8-79. Format of filename uppercase table: 


Offset Size Description 
00 WORD table size 
02 128 BYTEs uppercase equivalents (if any) of chars 80h to FFh 


Table 8-80. Format of DBCS lead byte table: 





Offset Size Description 
00) WORD length 
02h 2N BYTEs start/end for N lead byte ranges 


WORD 0000h — (end of table) 


INTERRUPT 21h - Function 65h, Subfunctions 20h-22h 
COUNTRY-DEPENDENT CHARACTER CAPITALIZATION 


Purpose: Capitalize text in a country-dependent fashion. 


Available on: DOS 4.0 or higher. Restrictions: none. 

Registers at call: Return Registers: 

AH = 65h CF set on error 

AL = function: AX = error code (see Function 59h) 
20h capitalize character: CF clear if successful 


DL = character to capitalize 
Return; DL = capitalized character 
21h capitalize string: 
DS:DX -> string to capitalize 
CX = length of string 
22h capitalize ASCIZ string: 
DS:DX -> ASCIZ string to capitalize 
Details: These calls have been documented for DOS 5.0, but were undocumented in DOS 4.x. 
Conflicts: None known. 


INTERRUPT 21h - Function 65h, Subfunction 23h 
DETERMINE IF CHARACTER REPRESENTS YES/NO RESPONSE 


Purpose: Translate "yes/no" responses for current country. 
Available on: DOS 4.0 or higher. Restrictions: This call is not documented and 
therefore subject to change. 
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Registers at call: Return Registers: 
AX = 6523h CF set on error 
DL = character CF clear if successful 
DH = second character of double-byte character (if AX = type: 
applicable) 00h no 
Olh yes 


02h neither yes nor no 
Conflicts: None known. 


INTERRUPT 21h - Function 65h, Subfunctions AQh-A2h 
COUNTRY-DEPENDENT FILENAME CAPITALIZATION 


Purpose: Perform capitalization of filenames properly for country. 


Available on: DOS 4.0 or higher. Restrictions: This call is not documented and 
therefore subject to change. 
Registers at call: Return Registers: 
AH = 65h CF set on error 
AL = function: AX = error code (see Function 59h) 
AOh capitalize filename character CF clear if successful 


DL = character to capitalize 
Return: DL = capitalized character 
Alh capitalize counted filename string 
DS:DX -> filename string to capitalize 
CX = length of string 
A2h capitalize ASCIZ filename 
DS:DX -> ASCIZ filename to capitalize 
Details: Nonfunctional in DOS 4.00 through 5.00 due to a bug (the code sets a pointer depending on whether the 
high bit of AL is set, but doesn't clear the bit before branching by function number). 
Conflicts: None known. 


INTERRUPT 21h - Function 66h, Subfunction 01h 
GET GLOBAL CODE PAGE TABLE 


Purpose: Determine current code-page table. 


Available on: DOS 3.3 or higher. Restrictions: none. 
Registers at call: Return Registers: \ 
AX = 6601h CF set on error i 


AX = error code (see Function 59h) 
CF clear if successful 
BX = active code page (see Function 66h 
Subfunction 02h) 
DX = system code page 
Conflicts: None known. 
See Also: Function 66h Subfunction 02h 


INTERRUPT 21h - Function 66h, Subfunction 02h 
SET GLOBAL CODE PAGE TABLE 


Purpose: Establish code-page table to use. 
Available on: DOS 3.3 or higher. Restrictions: none. 
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Registers at call: Return Registers: 
AX = 6602h CF set on error 
BX = active code page: AX = error code (see Function 59h) 
437 US CF clear if successful 
850 Multilingual 
852 Slavic (DOS 5+) 
860 Portugal 
861 Iceland 
863 Canada (French) 
865 Norway/Denmark 
DX = system code page (active page at boot time) 
Conflicts: None known. 
See Also: Function 66h Subfunction 01h 


INTERRUPT 21h - Function 67h 


SET HANDLE COUNT 

Purpose: Change maximum number of handles available to the calling program. 
Available on: DOS 3.3 or higher. Restrictions: none. 
Registers at call: Return Registers: 
AH = 67h CF clear if successful 
BX = size of new file handle table for process CF set on error 


AX = error code (see Function 59h) 

Details: If BX <= 20, no action is taken if the handle limit has not yet been increased, and the table is copied back 
into the PSP if the limit is currently greater than 20 handles. For file handle tables of more than 20 handles, DOS 
3.30 never reuses the same memory block, even if the limit is being reduced; this can lead to memory fragmentation 
as a new block is allocated and the existing one freed. 

Only the first 20 handles are copied to child processes in DOS 3.3. 
BUG: The original release of DOS 3.30 allocates a full 64K for the handle table on requests for an even number of 
handles. 
Conflicts: None known. 
See Also: Function 26h 


INTERRUPT 21h - Function 68h 
"FFLUSH" - COMMIT FILE 


Purpose: Forces a file to be updated on the disk. All data still in DOS disk buffers is written to disk immediately, 
and the file's directory entry is updated, 


Available on: DOS 3.3 or higher. Restrictions: none. 
Registers at call: Return Registers: 
AH = 68h CF clear if successful 
BX = file handle CF set on error 


AX = error code (see Function 59h) 
Conflicts: None known. 
See Also: Function 5Dh Subfunction 01h, INT 2Fh Function 11h Subfunction 07h (chapter 19) 


INTERRUPT 21h - Function 69h 

GET/SET DISK SERIAL NUMBER 

Purpose: Read or write volume label and serial number for the specified disk. 

Available on: DOS 4.0 or higher. Restrictions; This call is not documented and 
therefore subject to change. 
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Registers at call: Return Registers: 
AH = 69h CF set on error 
AL = subfunction: AX = error code (see Function 59h) 
00h get serial number CF clear if successful 
Olh set serial number AX destroyed 
BL = drive (O=default, 1=A, 2=B, etc) (AL = 00h) buffer filled with appropriate 
DS:DX -> disk serial number info (Table 8-81) values from extended BPB 


(AL = 01h) extended BPB on disk set to values 
from buffer 
Details: Does not generate a critical error; all errors are returned in AX. Error 0005h is returned if there is no 
extended BPB on the disk. This call does not work on network drives (error 0001h). The buffer after the first two 
bytes is an exact copy of bytes 27h thru 3Dh of the extended BPB on the disk. 
Conflicts: None known. 
See Also: Function 44h Subfunction 0Dh 


Table 8-81. Format of disk serial number info: 


Offset Size Description 
00h WORD info level (zero) 
02h DWORD _ disk serial number (binary) 
06h 1L BYTEs volume label or "NO NAME _ " if none present 
11h 8BYTEs (AL=00h only) filesystem type--string "FAT12 "or"FATI6 " 
INTERRUPT 21h - Function 6Ah 
Unknown Function 
Purpose: unknown. 
Available on: DOS 4.0 or higher. Restrictions; This call is not documented and 
therefore subject to change. 
Registers at call: Return Registers: unknown. 
AH = 6Ah 
other unknown. 
Details: This function may be equivalent to INT 21h Function 48h. 
INTERRUPT 21h - Function 6Bh 
Unknown Function 
Purpose: unknown, 
Available on: DOS 4.0 only. Restrictions: This call is not documented. 
Registers at call: Return Registers: 
AH = 6Bh CF set on error 
AL = subfunction: AX = error code (see INT 21h Function 59h) 
00h unknown. CF clear if successful 


DS:SI -> Current Directory Structure 
CL = drive (1=A:) 
Olh unknown. 
DS:SI -> unknown, 
CL = file handle 
02h unknown. 
DS:SI -> Current Directory Structure 
DI = unknown. 
CX = drive (1=A:) 
Others, if any, unknown. 
Details: This cali is passed through to INT 2Fh Function 11h Subfunction 2Fh with AX on top of the stack. 
Conflicts: None known. 
See Also: INT 2Fh Function 11h Subfunction 2Fh (chapter 19) 
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INTERRUPT 21h - Function 6Bh 


Null Function 

Purpose: This function does nothing and returns immediately. 

Available on: DOS 5.0. Restrictions: none. 
Registers at call: Return Registers: 
AH = 6Bh AL = 00h 


Conflicts: None known. 


INTERRUPT 21h - Function 6Ch, Subfunction 00h 


EXTENDED OPEN/CREATE 
Purpose: Combines functions of all older "open" and "create" functions into a single common function. 
Available on: DOS 4.0 or higher. Restrictions: none. 
Registers at call: Return Registers: 
AX = 6COOh CF set on error 
BL = open mode as in AL for normal open (INT AX = error code (see Function 59h) 
21h Function 3Dh): CF clear if successful 
bit 7: inheritance AX = file handle 
bits 4-6: sharing mode CX= | file opened 
bit 3 reserved 2 file created 
bits 0-2: access mode 3 file replaced 
BH = flags: 


bit 6 = auto commit on write 

bit 5 = return error rather than doing INT 24h 
CX = create attribute: 

bits 6-15 reserved 

bit 5: archive 

bit 4: reserved 

bit 3: volume label 

bit 2: system 

bit 1: hidden 

bit 0: readonly 
DL = action if file exists/does not exists: 

bits 7-4 action if file does not exist 

(0000 fail, 0001 create) 
bits 3-0 action if file exists 
(0000 fail, 0001 open, 0010 replace/open) 

DH = 00h (reserved) 
DS:SI -> ASCIZ file name 
Details: The PC LAN Program only supports DL=01h, DL=10h/sharing=compatibility, and DL=12h, 
Conflicts: None known. 
See Also: Functions 3Ch and 3Dh 


INTERRUPT 21h - Function 80h 
EXECUTE PROGRAM IN BACKGROUND 


Purpose: Load and begin executing a background program which does not require interactive input. 


Available on: European DOS 4.00 only. Restrictions: unknown 

Registers at call: Return Registers: 

AH = 80h CF clear if successful 

DS:DX -> ASCIZ full program name AX = CSID 

ES:BX -> parameter block (see Function 4Bh CF set on error 

Subfunction 00h) AX = error code (see Function 59h) 





Details: This function is equivalent to Function 4Bh Subfunction 04h. 
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See Also: Function 4Bh Subfunction 04h 
INTERRUPT 21h - Function 87h, Subfunction 00h 
GET PID 


Purpose: Determine Process Identifier, which indicates whether the calling program is foreground or the background 
program, 


Available on: European DOS 4.00 only. Restrictions: unknown 
Registers at call: Return Registers: 
AX = 8700h AX = PID if AL nonzero 


Details: Called by MS C v5.1 getpid() function. 
Conflicts: None known. 
See Also: Function 62h 


INTERRUPT 21h - Function 89h 


Unknown Function 

Purpose: unknown. 

Available on; European DOS 4.00 only Restrictions: unknown 
Registers at call: Return Registers: n/a 
AH = 89h 


other unknown, 
Details: This function is reportedly called by the Microsoft C 4.0 startup code. 
Conflicts: None known. 


INTERRUPT 22h 
PROGRAM TERMINATION ADDRESS 


Purpose: Specifies the address of the routine which is to be given control after a program is terminated; this interrupt 
should never be called directly, since it does not point at an interrupt handler. 

Available on: All versions of DOS. Restrictions: none. 

Details: This vector is restored from the DWORD at offset OAh in the PSP during termination, and then a far jump is 
performed to the address in INT 22h. It normally points at the instruction immediately following the INT 21h 
Function 4Bh call which loaded the current program. 

Conflicts: None known. 

See Also: INT 20h, INT 21h Functions 00h, 31h, and 4Ch 


INTERRUPT 23h 
CONTROL-C/CONTROL-BREAK HANDLER 


Purpose: Invoked by DOS whenever it detects a Control-C or Control-Break; should never be called directly. 


Available on: All versions of DOS. Restrictions: none. 
Registers at call: n/a Return Registers: (DOS 1.x) 
AH = 00h abort program 


if all registers preserved, restart DOS call 
Return Registers: (DOS 2+) 
return via RETF or RETF 2 with CF set 
DOS will abort program with errorlevel 0 
else 
interrupted DOS call continues if all registers 
preserved 
Details: MSDOS 1.25 also invokes INT 23h on a divide overflow (INT 00h). Any DOS call may safely be made 
from within the INT 23h handler, although the handler will need to check for a recursive invocation if it does call 
DOS. 
Conflicts: None known. 
See Also: INT [Bh (chapter 3} 


INTERRUPT 24h 
CRITICAL ERROR HANDLER 
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Purpose: Invoked when a critical (usually hardware) error is encountered; should never be called directly. 


Available on: All versions of DOS. 
Registers at call: (supplied by DOS) 
AH = type and processing flags: 
bit 7 clear = disk I/O error 
set = if block device, 
bad FAT image in memory 
if char device, error code in DI 
bit 6 unused 
bit 5 = | if Ignore allowed, 0 if not 
(DOS 3+) 
bit 4 = | if Retry allowed, 0 if not 
(DOS 3+) 
bit 3 = 1 if Fail allowed, 0 if not (DOS 3+) 
bit 2 disk area of error 00 = DOS area 
bit 1 / OL =FAT 
10 = root dir 
11 = data area 
bit 0 = | if write, 0 if read 
AL = drive number if AH bit 7 clear 
BP:SI -> device driver header (BP:[SI+4] bit 
15 set if char device) 
DI low byte contains error code 
if AH bit 7 set: 
00h write-protection violation attempted 
O1h unknown unit for driver 
02h drive not ready 
03h unknown command given to driver 
04h data error (bad CRC) 
05h bad device driver request structure 
length 
06h seek error 
07h unknown media type 
08h sector not found 
09h printer out of paper 
OAh write fault 
OBh read fault 
OCh general failure 
ODh (DOS 3+) sharing violation 
OEh (DOS 3+) lock violation 
OFh invalid disk change 
10h (DOS 3+) FCB unavailable 
1 Lh (DOS 3+) sharing buffer overflow 
12h (DOS 4+) code page mismatch 
{3h (DOS 4+) out of input 
14h (DOS 4+) insufficient disk space 





Restrictions: none. 
Handler must return: 
AL = action code: 
00h ignore error and continue processing request 
Olh retry operation 
02h terminate program through INT 23h 
03h fail system call in progress 
$5,SP,DS,ES,BX,CX,DX preserved 
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STACK: 
DWORD return address for INT 24h call 
WORD flags pushed by INT 24h 
WORD original AX on entry to INT 21h 
WORD BX 


WORD CX 
WORD DX 
WORD SI 
WORD DI 
WORD BP 
WORD DS 
WORD ES 


DWORD return address for INT 21h call 
WORD flags pushed by INT 21h 


Details: The only DOS calls the handler may make are INT 21h Functions Olh-OCh, 30h, and 59h. If the handler 
returns to the application by popping the stack, DOS will be in an unstable state until the first call with AH > 0Ch. 
For DOS 3.1+, IGNORE (AL=00h) is turned into FAIL (AL=03h) on network critical errors. If IGNORE is 
specified but not allowed, it is turned into FAIL. If RETRY is specified but not allowed, it is turned into FAIL. If 
FAIL is specified but not allowed, it is turned into ABORT. For DOS 3+, if a critical error occurs inside the critical 


error handler, the DOS call is automatically failed. 


Conflicts: None known. 
INTERRUPT 25h 
ABSOLUTE DISK READ (smail partitions) 


Purpose: Read disk by logical sector number. 
Available on: All versions of DOS. 





Registers at call: 

AL = drive number (00h = A:, 01h = B:, etc) 

CX = number of sectors to read 

DX = starting logical sector number (0000h to 
highest sector on drive) 

DS:BX -> buffer for data 


Restrictions: Only valid for disks and partitions up to 
32 MB. 
Return Registers: 
CF clear if successful 
CF set on error 
AH = status 
80h device failed to respond (timeout) 
40h seek operation failed 
20h controller failed 
10h data error (bad CRC) 
08h DMA failure 
04h requested sector not found 
03h write-protected disk (INT 26h only) 
02h bad address mark 
O1h bad command 
AL = error code (same as passed to INT 24h in DI) 
May destroy all other registers except segment 
registers 


Details: The original flags are left on the stack, and must be popped by the caller. This call bypasses the DOS 


filesystem, 


BUG: DOS 3.1 through 3.3 set the word at ES:[BP+1Eh] to FFFFh if AL is an invalid drive number. 


Conflicts: None known. 
See Also: INT 13h Function 02h, INT 26h 


INTERRUPT 25h - Function FFFFh 


ABSOLUTE DISK READ (large hard-disk partition) 


Purpose: Read disk from volume >32 Mb. 
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Available on: DOS 3.31 or higher, some OEM Restrictions: Drive must be larger than 32 MB. 
versions of DOS 3.30. 

Registers at call: Return Registers: same as above. 

AL = drive number (0=A, 1=B, etc) 

CX = FFFFh 


DS:BX -> disk read packet (Table 8-82) 

Details: Partition is potentially greater than 32M (and requires this form of the call) if bit | of the device driver's 
attribute word is set. The original flags are left on the stack, and must be removed by the caller. This call bypasses 
the DOS filesystem, 

Conflicts: None known. 

See Also: INT 13h Function 02h, INT 26h 


Table 8-82. Format of disk read packet: 


Offset Size Description 

00h DWORD sector number 

04h WORD number of sectors to read 
06h DWORD _ transfer address 
INTERRUPT 26h 


ABSOLUTE DISK WRITE (small partitions) 
Purpose: Absolute address write via Logical Sector Number. 


Available on: All versions of DOS, Restrictions: Only valid for disks and partitions up to 
32MB. 

Registers at call; Return Registers: 

AL = drive number (00h = A:, O1h = B:, etc) CF clear if successful 

CX = number of sectors to write CF set on error 

DX = starting logical sector number (0000h to AH = status: 

highest sector on drive) 80h device failed to respond (timeout) 
DS:BX -> data to write 40h seek operation failed 


20h controller failed 
10h data error (bad CRC) 
08h DMA failure 
04h requested sector not found 
03h write-protected disk (INT 26h only) 
02h bad address mark 
Olh bad command 
AL = error code (same as passed to INT 24h in DI) 
May destroy all other registers except segment 
registers 
Details: The original flags are left on the stack, and must be popped by the caller. This call bypasses the DOS 
filesystem. 
BUG: DOS 3.1 through 3.3 set the word at ES:[BP+1Eh] to FFFFh if AL is an invalid drive number. 
Conflicts: None known. 
See Also: INT 13h Function 03h, INT 25h 


INTERRUPT 26h - Function FFFFh 
ABSOLUTE DISK WRITE (large hard-disk partition) 


Purpose: Absolute address write via Logical Sector Number. 
Available on: DOS 3.31 or higher, some OEM Restrictions: Drive must be larger than 32 MB. 
versions of DOS 3,30. 
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Registers at call: Return Registers: same as above 

AL = drive number (0=A, I=B, etc) 

CX = FFFFh 

DS:BX -> disk write packet (Table 8-83) 

Details: Partition is potentially greater than 32M (and requires this form of the call) if bit 1 of the device driver's 
attribute word is set. The original flags are left on the stack, and must be removed by the caller. This call bypasses 
the DOS filesystem. 

Conflicts: None known. 

See Also: INT 13h Function 03h, INT 25h 


Table 8-83. Format of disk write packet: 


Offset Size Description 

00h DWORD _ sector number 

04h WORD number of sectors to read 
06h DWORD _ transfer address 
INTERRUPT 27h 


TERMINATE AND STAY RESIDENT 


Purpose: Terminate process without releasing the resources allocated to it; these resources include environment 
space, other memory, and file handles. 


Available on: All versions of DOS. Restrictions: none. 
Registers at call: Return Registers: never returns 
DX = number of bytes to keep resident 

(max FFFOh) 


CS = segment of PSP 

Details: This is an obsolete call; use INT 21h Function 31h instead for DOS 2.0 or higher, INT 22h, INT 23h, and 
INT 24h are restored from the PSP. 

Conflicts: None known. 

See Also: INT 21h Function 31h 


INTERRUPT 28h 
DOS IDLE INTERRUPT 


Purpose: Invoked each time one of the DOS character input functions loops while waiting for input. Since a DOS 
call is in progress even though DOS is actually idle during such input waits, hooking this function is necessary to 
allow a TSR to perform DOS calls while the foreground program is waiting for user input. 

Available on: DOS 2.0 or higher. Restrictions: The INT 28h handler may invoke any 
INT 21h function except functions 00h 
through 0Ch. 

Details: Under DOS 2.x, the critical error flag (the byte immediately after the InDOS flag) must be set in order to 

call DOS functions 50h/51h without destroying the DOS stacks. Calls to INT 21h Functions 3Fh/40h may not use a 

handle which refers to CON. 

At the time of the call, the InDOS flag (see INT 21h Function 34h) is normally set to 01h; if larger, DOS is truly 
busy and should not be reentered. ~ 

The default handler is an IRET instruction, This call is supported by the OS/2 compatibility box. 
Conflicts: None known. 
See Also: INT 21h Function 34h, INT 2Ah Function 84h 


INTERRUPT 29h 
FAST CONSOLE OUTPUT 


Purpose: Provides a simpler and faster means of displaying a single character than the normal device driver 
invocation of the CON device, 
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Available on: DOS 2.0 or higher. Restrictions: Current console driver must have 
attribute bit 4 set. 
Registers at call: Return Registers: nothing 


AL = character to display 
Details; COMMAND.COM v3.2 and v3.3 compare the INT 29h vector against the INT 20h vector and assume that 
ANSLSYS is installed if the segment of INT 29h is larger. 

The default INT 29h handler under DOS 2.x and 3.x simply calls INT 10h Function OEh (chapter 5), while the 
default handler under DESQview 2.2 understands the "<Ese>[2J" screen-clearing sequence but calls INT 10h 
Function 0Eh for all others, 

See Also: AVATAR.SYS INT 79h (chapter 36) 


INTERRUPT 2Bh 

RESERVED 

Purpose: This interrupt is not currently in use, but has been reserved for possible future use. 
Available on: DOS 2.0 or higher. Restrictions: none. 

Registers at call: n/a Return Registers: n/a 


Details: This vector is not used in DOS versions through 5.00, and points at an IRET. 
Conflicts: None known. 


INTERRUPT 2Ch 

RESERVED 

Purpose: This interrupt is not currently in use, but has been reserved for possible future use. 
Available on: DOS 2.0 or higher. Restrictions: none. 

Registers at call: n/a Return Registers: n/a 


Details: This vector is not used in DOS versions through 5.00, and points at an IRET. 
Conflicts: STARLITE architecture Kernel API, MS Windows (chapter 14). 


INTERRUPT 2Dh 

RESERVED 

Purpose: This interrupt is not currently in use, but has been reserved for possible future use. 
Available on: DOS 2.0 or higher. Restrictions: none. 

Registers at call: n/a Return Registers: n/a 


Details: This vector is not used in DOS versions through 5.00, and points at an IRET. 
Conflicts: None known, 


INTERRUPT 2Eh 
PASS COMMAND TO COMMAND INTERPRETER FOR EXECUTION 


Purpose: This call allows execution of arbitrary commands (including COMMAND.COM internal commands) 
without loading another copy of COMMAND,COM. 


Available on: DOS 2.0 or higher. Restrictions: COMMAND.COM must be installed. 
Registers at call: Return Registers: 
DS:SI -> commandline to execute (Table 8-84) All registers except CS:IP destroyed 


Details: If COMMAND.COM is the user's command interpreter, the primary copy executes the command; this 
allows the master environment to be modified by issuing a "SET" command, but changes in the master environment 
will not become effective until all programs descended from the primary COMMAND.COM terminate, 

Since COMMAND.COM processes the string as if typed from the keyboard, the transient portion needs to be 
present, and the calling program must ensure that sufficient memory to load the transient portion can be allocated by 
DOS if necessary. 

Results are unpredictable if invoked by a program run from a batch file because this call is not reentrant and 
COMMAND.COM uses the same internal variables when processing a batch file. 

Hooked but ignored by the 4DOS v3.0 COMMAND.COM replacement unless SHELL2E has been loaded. 
Conflicts: 4DO0S SHELL2E.COM TSR (Chapter 36). 
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Table 8-84, Format of COMMAND.COM commandline: 


Offset Size Description 
00h BYTE length of command string, not counting trailing CR 
Olh var command string 
N BYTE ODh (CR) 
INTERRUPT 30h 


FAR JMP instruction for CP/M-style calls 


Purpose: Used for CP/M compatible calls only; now obsolete. The CALL 5 entry point does a far jump to here. 


Available on: All versions of DOS. Restrictions: none. 
BUG: Under DOS 2+, the instruction at PSP:0005 points two bytes too low in memory. 
Conflicts: None known. 

See Also: INT 21h Function 26h 


INTERRUPT 31h 

Purpose: This vector is overwritten by the CP/M jump instruction in INT 30h, 

Available on: All versions of DOS, Restrictions: none. 
Conflicts: DOS Protected-Mode Interface (DPMI) API (chapter 11). 

INTERRUPT 6Ch 

Realtime Clock update 

Purpose: unknown. 

Available on: DOS 3.2. Restrictions: none. 
Registers at call: unknown. Return Registers: unknown. 


Conflicts: System Resume Vector (chapter 3). 


Multiplex Interrupt 


The multiplex interrupt, 2Fh, is shared by many programs, with the value of AH on call specifying the program 
which is to handle the call. A (probably incomplete) table of programs using this interrupt service appears in Chapter 
1; MS-DOS itself was the original user of the multiplex capability, and still accounts for a significant portion of 
activity in this area, The remainder of this chapter lists and describes the Multiplex functions that have been included 


in various versions of the operating system. 


In this section, the functions are listed alphabetically by name, rather than in numeric sequence by function. 


Within each named area, functions appear in numeric order by function and subfunction numbers. 
ANSISYS 
INTERRUPT 2Fh - Function 1Ah, Subfunction 00h 


INSTALLATION CHECK 

Purpose: Determine whether ANSI.SYS is installed. 

Available on: DOS 4.0 or higher. Restrictions: none. 
Registers at call: Return Registers: 
AX = 1A00h AL = FPh if installed 


Details: AVATAR.SYS also responds to this call. This function was undocumented in DOS 4.x, but has been 


documented for DOS 5.0. 
Conflicts: AVATAR.SYS (chapter 36). 


INTERRUPT 2Fh - Function 1Ah, Subfunction 01h 
internal - GET/SET DISPLAY INFORMATION 


Purpose: Control display information. 
Available on: DOS 4.0 or higher. Restrictions: ANSLSYS must be installed, 
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Registers at call: Return Registers: 
AX = [AOIh CF set on error 
CL = 7Fh for GET AX = error code (many non-standard) 

= 5Fh for SET CF clear if successful 
DS:DX -> parm block as for INT 21h Function 44h AX destroyed 

Subfunction 0Ch, CX=037Fh/035Fh 

respectively 


Details: This is presumably the DOS [OCTL interface to ANSLSYS. 
Conflicts: None known. 
See Also: Function 1Ah Subfunction 02h, INT 21h Function 44h Subfunction 0Ch 


INTERRUPT 2Fh - Function 1Ah, Subfunction 02h 
internal - MISCELLANEOUS REQUESTS 


Purpose: Control interlocks. 

Available on: DOS 4.0 or higher. 
Registers at call: 

AX = LA02h 

DS:DX -> parameter block (Table 8-85) 
Conflicts: None known. 

See Also: Function 1Ah Subfunction 01h 


Restrictions: ANSLSYS must be installed. 


Table 8-85. Format of parameter block: 


Offset Size Description 

00h BYTE subfunction 
00h set/reset interlock 
Olh get /L flag 

Oth BYTE interlock state: OOh=reset, OLh=set 


8-99 


This interlock prevents some of the ANSLSYS post-processing in its hook onto INT 10h 


Function 00h mode set 
02h BYTE (returned) 

00h if /L not in effect 

Olh if /L in effect 


APPEND 
INTERRUPT 2Fh - Function B7h, Subfunction 00h 
INSTALLATION CHECK 
Purpose: Determine whether APPEND is installed. 
Available on: All machines, Restrictions: none. 
Registers at call: Return Registers: 
AX = B700h AL = status: 
00h not installed 
FFh installed 
Details: MSDOS 3.30 APPEND refuses to install itself when run inside TopView or a TopView-compatible 
environment. 
INTERRUPT 2Fh - Function B7h, Subfunction 01h 
Unknown Function 
Purpose: unknown. 
Available on: All machines, Restrictions; APPEND must be installed, 
Registers at call: Return Registers: unknown. 
AX =B701h 


other weknown. 
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Details: MSDOS 3.30 APPEND displays "Incorrect APPEND Version" and aborts caller. 
INTERRUPT 2Fh - Function B7h, Subfunction 02h 


APPEND VERSION CHECK 

Purpose: Determine which version of APPEND is installed. 

Available on: All machines. Restrictions: APPEND must be installed. 
Registers at call: Return Registers: 

AX = B702h AX = FFFFh if not DOS 4.0 APPEND (also if 


DOS 5.0 APPEND); 
AL = major version number 
AH = minor version number, otherwise 
Conflicts: None known. 
See Also: Function B7h Subfunction 10h 


INTERRUPT 2Fh - Function B7h, Subfunction 03h 

HOOK INT 2th 

Purpose: Each invocation of this function toggles a flag which APPEND uses to determine whether to chain to the 
user handler or the original INT 21h. 


Available on: DOS 3.3 and 5.0. Restrictions: APPEND must be installed. 
Registers at call: Return Registers: 
AX = B703h ES:DI -> APPEND's INT 21h handler 


ES:DI -> INT 21h handler to which APPEND 
should chain 
Conflicts: None known. 


INTERRUPT 2Fh - Function B7h, Subfunction 04h 


GET APPEND PATH 

Purpose: Determine the currently active APPEND path. 

Available on: DOS 3.3 or higher. Restrictions: APPEND must be installed. 
Registers at call: Return Registers: 

AX = B704h ES:DI -> active APPEND path (128 bytes max) 


Conflicts: None known. 


INTERRUPT 2Fh - Function B7h, Subfunction 06h 
GET APPEND FUNCTION STATE 


Purpose: Determine current state of APPEND. 


Available on: DOS 4.0 or higher. Restrictions: APPEND must be installed. 
Registers at call: Return Registers: 
AX = B706h BX = APPEND state: 


bit 0: set if APPEND enabled 

bits 1-11 reserved 

bit 12: (DOS 5) set if APPEND applies directory 
search even if a drive has been specified 

bit 13; set if (PATH flag active 

bit 14: set if /E flag active (environment var 
APPEND exists) 

bit 15: set if /X flag active 

Conflicts: None known, 


INTERRUPT 2Fh - Function B7h, Subfunction 07h 
SET APPEND FUNCTION STATE 


Purpose: Sets state of APPEND. 
Available on: DOS 4.0 or higher. Restrictions: APPEND must be installed. 
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Registers at call: Return Registers: n/a 


AX = B707h 
BX = APPEND state bits (see Subfunction 06h) 
Conflicts: None known. 


INTERRUPT 2Fh - Function B7h, Subfunction 10h 


GET VERSION INFO 

Purpose: Obtain version of APPEND. 

Available on: DOS 3.3 or higher. Restrictions: APPEND must be installed. 
Registers at call: Return Registers: 

AX =B710h AX = unknown. 


BX = unknown. (0000h in MSDOS 3.30 and 5.00) 
CX = unknown. (0000h in MSDOS 3.30 and 5.00) 
DL = major version 
DH = minor version 

Conflicts: None known. 

See Also: Function B7h Subfunction 02h 


INTERRUPT 2Fh - Function B7h, Subfunction 11h 

SET RETURN FOUND NAME STATE 

Purpose: If the next INT 21h call (and ONLY the next) is function 3Dh, 43h, or 6Ch, the fully qualified filename is 
written over top of the filename passed to the INT 2th call. The application must provide a sufficiently large buffer. 
This state is reset after next INT 21h call processed by APPEND. 


Available on: DOS 4.0 or higher. Restrictions: APPEND must be installed. 
Registers at call: Return Registers: n/a 
AX=B71tIh 

Conflicts: None known. 

ASSIGN 

INTERRUPT 2Fh - Function 06h, Subfunction 00h 

INSTALLATION CHECK 

Purpose: Determine whether ASSIGN installed. 

Available on: DOS 3.0 or higher. Restrictions: none. 
Registers at call: Return Registers: 
AX = 0600h AL = status: 


00h not installed 
Oth not installed, but not OK to install 
FFh installed 

Conflicts: None known. 

See Also: Function 06h Subfunction OLh 


INTERRUPT 2Fh - Function 06h, Subfunction 01h 
GET DRIVE ASSIGNMENT TABLE 


Purpose: Determine drive assignments. 


Available on: DOS 3.0 or higher. Restrictions: ASSIGN must be installed. 

Registers at call: Return Registers: 

AX = 0601h ES = segment of ASSIGN work area and assignment 
table 


Details: The 26 bytes starting at ES:0103h specify which drive each of A: to Z: is mapped to. Initially set to 01h 02h 
03h ... LA. 

Conflicts: None known. 

See Also: Function 06h Subfunction 00h 
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COMMAND.COM 

INTERRUPT 2Fh - Function 55h, Subfunction 00h 

COMMAND.COM INTERFACE 

Purpose: Determine the addresses of various routines which may be shared between copies of COMMAND.COM. 
Available on: DOS 5.0 or higher. Restrictions; COMMAND.COM must be the shell. 
Registers at call: Return Registers: 

AX =5500h AX = 0000h if COMMAND.COM present 


DS:SI -> entry point table 
Details: The entry point table is used to access the shareable portion of COMMAND.COM, which may have been 
moved into the HMA; only the primary COMMAND.COM retains this portion. The procedures pointed at by the 
table are called from a dispatcher in COMMAND's resident portion; most assume that the segment address of the 
resident portion is on the stack and are thus not of general use. 
Conflicts: None known. 


CRITICAL ERROR HANDLER 


INTERRUPT 2Fh - Function 05h, Subfunction 00h 
CRITICAL ERROR HANDLER - INSTALLATION CHECK 


Purpose: Determine whether Critical Error message handler is installed. 


Available on: DOS 3.0 or higher. Restrictions: none. 

Registers at call: Return Registers: 

AX = 0500h AL = 00h not installed, OK to install 
Olh not installed, can't install 
FFh installed 


Details: This set of functions allows a user program to partially or completely override the default critical error 
handler in COMMAND.COM. 

Conflicts: None known. 

See Also: Function 12h Subfunction 2Eh, INT 24h 


INTERRUPT 2Fh - Function 05h, Subfunctions 01h-FFh 
CRITICAL ERROR HANDLER - EXPAND ERROR INTO STRING 


Purpose: Called at start of COMMAND.COM's default critical error handler if installed by a user program, allowing 
partial or complete overriding of the default error message. 


Available on: DOS 3.0 or higher. Restrictions: Critical Error Handler must be installed. 
Registers at call: Return Registers: 

---DOS 3.x CF clear if successful 

AH =05h ES:DI -> ASCIZ error message (read-only) 

AL = extended error code (not zero) AL = unknown. 

---DOS 4.x CF set if error code can't be converted to string 

AH = 05h 


AL = error type: 
Olh DOS extended error code 
02h parameter error 
BX = error code 
Details: Subfunction 02h is called by many DOS 4 external programs. 
Conflicts: None known. 
See Also: Function 12h Subfunction 2Eh, INT 24h 


DISPLAY.SYS 


INTERRUPT 2Fh - Function ADh, Subfunction 00h 
internal - INSTALLATION CHECK 
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Purpose: Determine whether the DISPLAY.SYS driver is installed, 


Available on: DOS 3.3 or higher. 
Registers at call: 
AX = ADOOh 


Conflicts: None known. 


INTERRUPT 2Fh - Function ADh, Subfunction 01h 
internal - SET unknown value 


Purpose: unknown, 

Available on: DOS 3.3 or higher. 
Registers at call: 

AX=ADOlh 

BX = unknown, 

Conflicts: None known, 


INTERRUPT 2Fh - Function ADh, Subfunction 02h 


internal - GET unknown value 


Purpose: unknown. 

Available on: DOS 3.3 or higher. 
Registers at call: 

AX = ADO2h 

Conflicts: None known, 


INTERRUPT 2Fh - Function ADh, Subfunction 03h 
internal - GET unknown value 


Purpose: unknown. 

Available on: DOS 3.3 or higher. 
Registers at call: 

AX = ADO3h 

ES:DI -> user buffer 

CX = size of buffer 

Conflicts: None known. 


INTERRUPT 2Fh - Function ADh, Subfunction 04h 


internal - Unknown Function 


Purpose: unknown, 
Available on: DOS 4.x only. 
Registers at call: 

AX = AD04h 

other weknown. 


INTERRUPT 2Fh - Function ADh, Subfunction 10h 
internal - INSTALLATION CHECK 


Purpose: unknown. 
Available on: DOS 4.0 or higher. 


Restrictions: none. 

Return Registers: 

AL = FFh if installed 

BX = unknown. (0100h in MS-DOS 3,30, PCDOS 
4.01) 


Restrictions: DISPLAY.SYS driver must be installed. 
Return Registers: 

CF set on error 

other unknown. 


Restrictions: DISPLAY.SYS driver must be installed. 
Return Registers: 
BX = unknown. (value set with Subfunction 01h) 


Restrictions: DISPLAY.SYS driver must be installed. 
Return Registers: 

CF set if buffer too small 

CF clear if successful 


Restrictions: DISPLAY.SYS driver must be installed. 
Return Registers: unknown. 


Restrictions: DISPLAY.SYS driver must be installed. 
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Registers at call: Return Registers: 

AX = AD10h AX = FFFFh 

other unknown. BX = unknown. (0100h in PCDOS 4.01) 
DOS DISK ACCESS 


INTERRUPT 2Fh - Function 13h 
SET DISK INTERRUPT HANDLER 


Purpose: Specify which routines DOS's built-in disk device drivers call. 


Available on: DOS 3.30 or higher. Restrictions: none. 

Registers at call: Return Registers: 

AH=13h DS:DX from previous invocation of this function 

DS:DX -> interrupt handler disk driver calls on ES:BX from previous invocation of this function 
read/write 


ES:BX = address to restore INT 13 to on system 

halt (exit from root shell) or warm boot 

(INT 19) 

Details: IO.SYS hooks INT 13h and inserts one or more filters ahead of the original INT 13h handler. The first is 
for disk change detection on floppy drives, the second is for tracking formatting calls and correcting DMA boundary 
errors, the third is for working around problems in a particular version of IBM's ROM BIOS. 

Before the first call, ES:BX points at the original BIOS INT 13; DS:DX also points there unless IO.SYS has 
installed a special filter for hard disk reads (on systems with model byte FCh and BIOS date "01/10/84" only), in 
which case it points at the special filter. 

Most DOS 3.3+ disk access is via the vector in DS:DX, although a few functions are still invoked via an INT 13 
instruction. This is a dangerous security loophole for any virus-monitoring software which does not trap this call (at 
least two viruses are known to use it to get the original ROM entry point). 

See Also: INT 13h Function 01h (chapter 6), INT 19h (chapter 3) 


DOS INTERNAL 
Beginning with version 3.0, DOS provides a number of utility functions for use by SHARE, network redirectors, and 
similar software. Several of these functions assume that an INT 21h call is in progress; most of the remainder 
assume that the active stack is one of the internal DOS stacks, making them effectively only available from within an 
INT 21h call. 

DOS version 5.0 adds additional calls on other multiplex numbers; these are included here in numerical order. 


INTERRUPT 2Fh - Function 12h, Subfunction 00h 
internal - INSTALLATION CHECK 


Purpose: Determine whether DOS internal functions API is present. 


Available on: DOS 3.0 or higher. Restrictions: none. 

Registers at call: Return Registers: 

AX = 1200h AL = FFh (for compatibility with other INT 2Fh 
functions) 


Conflicts: None known. 


INTERRUPT 2Fh - Function 12h, Subfunction 01h 
internal - CLOSE CURRENT FILE 


Purpose: Closes current file. 


Available on: DOS 3.0 or higher. Restrictions: none. 

Registers at call: Return Registers: 

AX = 1201h CF set on error 

SS = DOS DS BX unknown. 

SDA current SFT pointer -> SFT of file to close CX = new reference count of SFT 


ES:DI -> SFT for file 


| 
| 
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Conflicts: None known. 
See Also: Function 11h Subfunction 06h (chapter 19), Function 12h Subfunction 27h, INT 21h Function 3Eh 


INTERRUPT 2Fh - Function 12h, Subfunction 02h 

internal - GET INTERRUPT ADDRESS 

Purpose: Similar to INT 21h Function 25h but does not use INT 21h dispatcher code and returns the address of the 
DWORD storing the interrupt vector rather than the contents of the vector. 


Available on: DOS 3.0 or higher. Restrictions: none. 
Registers at call: Return Registers: 
AX = 1202h ES:BX -> interrupt vector 
STACK: WORD vector number STACK unchanged 


Conflicts: None known. 


INTERRUPT 2Fh - Function 12h, Subfunction 03h 
internal - GET DOS DATA SEGMENT 


Purpose: Determine segment address of data area in the DOS kernel. 


Available on: DOS 3.0 or higher. Restrictions: none. 
Registers at call: Return Registers: 
AX = 1203h DS = segment of IBMDOS.COM/MSDOS.SYS data 


Conflicts: None known. 


INTERRUPT 2Fh - Function 12h, Subfunction 04h 
internal - NORMALIZE PATH SEPARATOR 


Purpose: Identify whether the specified character separates directories in a path specification, and turn it into the 
standard backslash if so. 


Available on: DOS 3.0 or higher. Restrictions: none. 
Registers at call: Return Registers: 
AX = 1204h AL = normalized character 
STACK: WORD character to normalize (forward slash turned to backslash, all others 
unchanged) 
ZF set if character is a path separator 
STACK unchanged 


Details: Characters returned by this call may not be recognized by all programs, 
Conflicts: None known. 


INTERRUPT 2Fh - Function 12h, Subfunction 05h 
internal - OUTPUT CHARACTER TO STANDARD OUTPUT 


Purpose: Sends one character to the predefined STDOUT handle. 


Available on: DOS 3.0 or higher. Restrictions: Can be called only from within DOS. 
Registers at call: Return Registers: 
AX = 1205h STACK unchanged 


STACK: WORD character to output 
Conflicts: None known. 


INTERRUPT 2Fh - Function 12h, Subfunction 06h 
internal - INVOKE CRITICAL ERROR 


Purpose: Calls critical error handler. 
Available on: DOS 3.0 or higher. Restrictions: none. 





} 
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Registers at call: Return Registers: 
AX = 1206h AL = 0-3 for Abort, Retry, Ignore, Fail 
DI = error code STACK unchanged 
BP:SI -> device driver header 
SS = DOS DS 
STACK: WORD value to be passed to INT 24h in 
AX 


Conflicts: None known. 
See Also: INT 24h 


INTERRUPT 2Fh - Function 12h, Subfunction 07h 
internal - MAKE DISK BUFFER MOST-RECENTLY USED 


Purpose: Moves buffer to the end of the buffer list (least-recently used is first). 


Available on: DOS 3.0 or higher. Restrictions: Can be called only from within DOS. 
Registers at call: Return Registers: n/a 
AX = 1207h 


DS:DI -> disk buffer 
Conflicts: None known. 
See Also: Function 12h Subfunction OFh 


INTERRUPT 2Fh - Function 12h, Subfunction 08h 
internal - DECREMENT SFT REFERENCE COUNT 


Purpose: Reduce use-count of a System File Table entry; used when closing a file. 


Available on: DOS 3.0 or higher. Restrictions: none. 

Registers at call: Return Registers: 

AX = 1208h AX = original value of reference count 
ES:DI -> SFT 


Details: If the reference count was 1, it is set to FFFFh (since 0 indicates that the SFT is not in use). It is the caller's 
responsibility to set the reference count to zero after cleaning up. 
Conflicts: None known. 


INTERRUPT 2Fh - Function 12h, Subfunction 09h 
internal - FLUSH AND FREE DISK BUFFER 


Purpose: Mark disk buffer as unused, and write contents to disk if buffer is dirty. 


Available on: DOS 3.0 or higher. Restrictions: Can be called only from within DOS. 
Registers at call: Return Registers: n/a 
AX = 1209h 


DS:DI -> disk buffer 
Conflicts: None known. 
See Also: Function 12h Subfunctions OEh and 15h 


INTERRUPT 2Fh - Function 12h, Subfunction OAh 
internal - PERFORM CRITICAL ERROR INTERRUPT 


Purpose: Calls critical error handler from DOS. 

Available on: DOS 3.0 or higher. Restrictions; Can only be called during a DOS 
function call, as it uses various fields in 
the SDA to set up the registers for the 


INT 24h. 
Registers at call: Return Registers: 
AX = 120Ah AL = user response (O=ignore, [=retry, 2=abort, 
DS = SS = DOS DS 3=fail) 
STACK: WORD extended error code CF clear if retry, set otherwise 


STACK unchanged 
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Details: Reportedly sets current DPB's first root directory sector to 1. 
Conflicts: None known. 
See Also: INT 24h 


INTERRUPT 2Fh - Function 12h, Subfunction OBh 
internal - SIGNAL SHARING VIOLATION TO USER 


Purpose: Notify user that sharing rules have been violated. 


Available on: DOS 3.0 or higher. Restrictions: Can only be called during a DOS 
function call. 
Registers at call: Return Registers: 
AX = 120Bh CF clear if operation should be retried 
ES:DI -> system file table entry for previous open CF set if operation should not be retried 
of file AX = error code (20h) (see Function 59h) 
STACK: WORD extended error code (should be STACK unchanged 


20h--sharing violation) 
Details; Should only be called if an attempt was made to open an already-open file contrary to the sharing rules, 
Invokes INT 24h if SFT file opened via FCB or in compatibility mode with inheritance allowed. 


Conflicts: None known. 


INTERRUPT 2Fh - Function 12h, Subfunction 0Ch 
internal - OPEN DEVICE AND SET SFT OWNER 


Purpose: Changes owner of last-accessed SFT to calling process if it was opened via an FCB call. Called by 
network redirectors, 


Available on: DOS 3.0 or higher. Restrictions: none. 
Registers at call: Return Registers: 
AX = [20Ch ES, DI, AX destroyed 


SDA current SFT pointer -> SFT for file 

DS =SS = DOS DS 

Details: This call invokes the "device open" function of the SFT's device driver. 
Conflicts: None known. 


INTERRUPT 2Fh - Function 12h, Subfunction 0Dh 
internal - GET DATE AND TIME 


Purpose: Get system date and time in file directory format. 


Available on: DOS 3.0 or higher. Restrictions: none. 

Registers at call: Return Registers: 

AX = 120Dh AX = current date in packed format (see INT 21h 
SS = DOS DS Function 57h Subfunction 00h) 


DX = current time in packed format (see INT 21h 
Function 57h Subfunction 00h) 


Conflicts: None known, 
See Also: INT 21h Functions 2Ah and 2Ch 


INTERRUPT 2Fh - Function 12h, Subfunction OEh 
internal - MARK ALL DISK BUFFERS UNREFERENCED 


Purpose: Clears "referenced" flag on all disk buffers. 


Available on: DOS 3.0 or higher. Restrictions; none. 
Registers at call: Return Registers: 

AX = 120Eh DS:DI -> first disk buffer 
SS = DOS DS 


Conflicts: None known. 
See Also: Function 12h Subfunctions 09h and 10h, INT 21h Function 0Dh 
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INTERRUPT 2Fh - Function 12h, Subfunction OFh 
internal - MAKE BUFFER MOST RECENTLY USED 


Purpose: The indicated disk buffer is moved to end of the buffer chain, which is ordered by decreasing time since 


last use. 

Available on: DOS 3.0 or higher. 
Registers at call: 

AX = 120Fh 

DS:DI -> disk buffer 

SS = DOS DS 

Conflicts: None known. 

See Also: Function 12h Subfunction 07h 


INTERRUPT 2Fh - Function 12h, Subfunction 10h 
internal - FIND UNREFERENCED DISK BUFFER 


Purpose: Locate an unreferenced disk buffer. 
Available on: DOS 3.0 or higher. 

Registers at call: 

AX = 1210h 

DS:DI -> first disk buffer to check 


Conflicts: None known. 
See Also: Function 12h Subfunction OEh 


INTERRUPT 2Fh - Function 12h, Subfunction 11h 
internal - NORMALIZE ASCIZ FILENAME 


Restrictions: none. 
Return Registers: 
DS:DI -> next buffer in buffer list 


Restrictions: none. 
Return Registers: 
ZF clear if found 
DS:DI -> first unreferenced disk buffer 
ZF set if not found 


Purpose: Fills destination buffer with uppercase filename, converting slashes to backslashes. 


Available on: DOS 3.0 or higher. 

Registers at call: 

AX = 121 1h 

DS:SI -> ASCIZ filename to normalize 

ES:DI -> buffer for normalized filename 
Conflicts: None known. 

See Also: Function 12h Subfunctions 1Eh and 21h 


INTERRUPT 2Fh - Function 12h, Subfunction 12h 
internal - GET LENGTH OF ASCIZ STRING 


Restrictions: none. 
Return Registers:| 
ES:DI buffer filled with normalized filename i 


Purpose: Count number of characters in null-terminated string. 


Available on: DOS 3.0 or higher. 
Registers at call: 

AX = 1212h 

ES:DI -> ASCIZ string 

Conflicts: None known. 

See Also: Function 12h Subfunction 25h 


INTERRUPT 2Fh - Function 12h, Subfunction 13h 
internal - UPPERCASE CHARACTER 


Purpose: Convert a character to uppercase. 
Available on: DOS 3.0 or higher. 

Registers at call: 

AX = 1213h 

STACK: WORD character to convert to uppercase 
Conflicts: None known. 


Restrictions: none. 
Return Registers: 
CX = length of string 


Restrictions: none. 
Return Registers: 
AL = uppercase character 
STACK unchanged 





\ 
i 
\ 
| 
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INTERRUPT 2Fh - Function 12h, Subfunction 14h 
internal - COMPARE FAR POINTERS 


Purpose: Compare two far pointers for identity. 
Available on: DOS 3.0 or higher. 

Registers at call: 

AX =1214h 

DS:SI = first pointer 

ES:DI = second pointer 
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Restrictions: none. 
Return Registers: 
ZF set if pointers are equal, ZF clear if not equal. 


Details: No assumptions or normalizations are made; if the pointers are not bit-for-bit identical, the function returns 


"not equal”. 
Conflicts: None known, 


INTERRUPT 2Fh - Function 12h, Subfunction 15h 
internal - FLUSH BUFFER 


Purpose: Force buffer to be written to disk if it has been modified. 


Available on: DOS 3.0 or higher. 
Registers at call: 

AX = 1215h 

DS:DI -> disk buffer 

SS = DOS DS 

STACK: 

WORD drives for which to skip buffer; ignore 
buffer if drive same as high byte, or bytes 
differ and the buffer is for a drive OTHER 
than that given in low byte 

Conflicts: None known. 
See Also: Function 12h Subfunction 09h 


INTERRUPT 2Fh - Function 12h, Subfunction 16h 
internal - GET ADDRESS OF SYSTEM FILE TABLE 


Purpose: Obtain a far pointer to the specified SFT entry. 
Available on: DOS 3.0 or higher. 

Registers at call: 

AX = 1216h 

BX = system file table entry number 


Conflicts: None known. 
See Also: Function 12h Subfunction 20h 


INTERRUPT 2Fh - Function 12h, Subfunction 17h 
internal - SET WORKING DRIVE 


Purpose: Establish current default drive. 
Available on: DOS 3.0 or higher. 
Registers at call: 

AX = 1217h 

SS = DOS DS 

STACK: WORD drive (0 = A;, 1 = B:, etc) 


Conflicts: None known. 
See Also: Function 12h Subfunction 19h 


Restrictions: Can be called only from within DOS. 
Return Registers: 
STACK unchanged 


Restrictions: none. 
Return Registers: 
CF clear if successful 
ES:DI -> system file table entry 
CF set if BX greater than FILES= 


Restrictions: none. 
Return Registers: 
CF set on error 
(drive > LASTDRIVE) 
CF clear if successful 
DS:SI -> current directory structure for specified 
drive 
STACK unchanged 
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INTERRUPT 2Fh - Function 12h, Subfunction 18h 
internal - GET CALLER'S REGISTERS 


Purpose: Obtain far pointer to DOS register-save locations. 


Available on: DOS 3.0 or higher. 
Registers at call: 
AX = 1218h 


Conflicts: None known. 


INTERRUPT 2Fh - Function 12h, Subfunction 19h 
internal - SET DRIVE 


Purpose: unknown. 

Available on: DOS 3.0 or higher. 

Registers at call: 

AX = 1219h 

SS = DOS DS 

STACK: WORD drive (0 = default, 1 = A:, etc) 


Restrictions: Only valid while within a DOS call. 

Return Registers: 

DS:SI -> saved caller's AX, BX, CX, DX, SI, DI, BP, 
DS, ES (on stack) 


Restrictions: none. 
Return Registers: 
STACK unchanged 


Details: Calls Function 12h Subfunction 17h. Builds a current directory structure if inside server call (INT 21h 


Function 5Dh Subfunction 00h). 
Conflicts: None known. 
See Also: Function 12h Subfunctions 17h and 1Fh 


INTERRUPT 2Fh - Function 12h, Subfunction 1Ah 
internal - GET FILE'S DRIVE 


Purpose: Separate drive and path in pathspec. 
Available on: DOS 3.0 or higher. 

Registers at call: 

AX = 121Ah 

DS:SI -> filename 

Conflicts; None known. 

See Also: INT 21h Functions 19h and 60h 


INTERRUPT 2Fh - Function 12h, Subfunction 1Bh 
internal SET YEAR AND LENGTH OF FEBRUARY 


Purpose: Modify DOS month table for leap years. 
Available on: DOS 3.0 or higher. 


Registers at call: 

AX = 121Bh 

CL = year - 1980 

Conflicts: None known, 

See Also: INT 21h Function 2Bh 


INTERRUPT 2Fh - Function 12h, Subfunction 1Ch 
internal - CHECKSUM MEMORY 


Restrictions: none. 
Return Registers: 
AL = drive (0 = default, 1 = A:, etc, FFh = invalid) 
DS:SI -> filename without leading "X:" (if present) 


Restrictions: Requires DS to be set to the DOS data 
segment, 

Return Registers: 

AL = number of days in February 


Purpose: Tally days from month table to determine day count; also useful to redirectors as a general checksum 


function. 

Available on: DOS 3.0 or higher. 
Registers at call: 

AX = 121Ch 

DS:SI -> start of memory to checksum 
CX = number of bytes 


Restrictions: none. 

Return Registers: 

AX, CX destroyed 

DX = checksum 

DS:SI -> first byte after checksummed range 
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DX = initial checksum 

SS = DOS DS 

Details: Used by DOS to determine day count since 1/1/80 given a date. 
Conflicts: None known. 

See Also: Function 12h Subfunction 1Dh 


INTERRUPT 2Fh - Function 12h, Subfunction 1Dh 


internal - SUM MEMORY 

Purpose: Used by DOS to determine year or month given the count of days since 1/1/80. 

Available on: DOS 3.0 or higher. Restrictions: none. 

Registers at call: Return Registers: 

AX = 121Dh AL = byte which exceeded limit 

DS:SI -> memory to add up CX = number of bytes before limit exceeded 

CX = 0000h DX = remainder after adding first CX bytes 

DX = limit DS:SI -> byte beyond the one which exceeded the limit 


Conflicts: None known, 
See Also: Function 12h Subfunction 1Ch 


INTERRUPT 2Fh - Function 12h, Subfunction 1Eh 
internal - COMPARE FILENAMES 


Purpose: Determine whether two filenames are equivalent when ignoring case and forward/backslash differences. 


Available on: DOS 3.0 or higher. Restrictions: none. 
Registers at call: Return Registers: 
AX = 121Eh ZF set if filenames equivalent, ZF clear if not 


DS:SI -> first ASCIZ filename 

ES:DI -> second ASCIZ filename 

Conflicts: None known. 

See Also: Function 12h Subfunction 11h, Function 12h Subfunction 21h 


INTERRUPT 2Fh - Function 12h, Subfunction 1Fh 
internal - BUILD CURRENT DIRECTORY STRUCTURE 


Purpose: Creates a current directory structure for the given drive in a temporary buffer, 


Available on: DOS 3.0 or higher. Restrictions: none. 

Registers at call: Return Registers: 

AX = 121Fh ES:DI -> current directory structure (will be 
SS = DOS DS overwritten by next call) 

STACK: WORD drive letter STACK unchanged 


Conflicts: None known. 


INTERRUPT 2Fh - Function 12h, Subfunction 20h 
internal - GET JOB FILE TABLE ENTRY 


Purpose: Convert "file handle” to SFT index number using job's handle table. 


Available on: DOS 3.0 or higher. Restrictions: none. 

Registers at call: Return Registers: 

AX = 1220h CF set on error 

BX = file handle AL = 6 (invalid file handle) 


CF clear if successful 
ES:DI -> JFT entry for file handle in current 
process 
Details: The byte pointed at by ES:DI contains the number of the SFT for the file handle, or FFh if the handle is not 
open. 
Conflicts: None known. 
See Also: Function 12h Subfunctions 16h and 29h 
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INTERRUPT 2Fh - Function 12h, Subfunction 21h 
internal - CANONICALIZE FILE NAME 


Purpose: Identical to INT 21h Function 60h. 


Available on: DOS 3.0 or higher. Restrictions: none. 
Registers at call: Return Registers: (see INT 21h Function 60h) 
AX = 1221h 


DS:SI -> file name to be fully qualified 
ES:DI -> 128-byte buffer for resulting canonical file 
name 
SS = DOS DS 
Conflicts: None known. 
See Also: Function 11h Subfunction 23h, INT 21h Function 60h 


INTERRUPT 2Fh - Function 12h, Subfunction 22h 
internal - SET EXTENDED ERROR INFO 


Purpose: Modify tables used by INT21h Function 59h. 


Available on: DOS 3.0 or higher. Restrictions: Can be called only from within DOS. 
Registers at call: Return Registers: 

AX = 1222h SI destroyed 

SS = DOS data segment SDA error class, error locus, and suggested action 
SS:SI -> 4-byte records fields set 


BYTE error code, FFh = last record 
BYTE error class, FFh = don't change 
BYTE suggested action, FFh = don't change 
BYTE error locus, FFh = don't change 
SDA error code field set 
Conflicts: None known. 
See Also: Function 12h Subfunction 2Dh, INT 21h Function 59h 


INTERRUPT 2Fh - Function 12h, Subfunction 23h 
internal - CHECK IF CHARACTER DEVICE 


Purpose: Determine whether the supplied name is a character device. 


Available on: DOS 3.0 or higher. Restrictions: Can only be called from within DOS 
(assumes DS=SS=DOS DS). 
Registers at call: Return Registers: 
AX = 1223h CF set if no character device by that name found 
SDA+218h (DOS 3.10-3.30) = eight-character CF clear if found 
blank-padded name BH = low byte of device attribute word 


SDA+22Bh (DOS 4.0x) = eight-character blank- 
padded name 
Conflicts: None known. 
See Also: INT 21h Function SDh Subfunction 06h, INT 21h Function 5Dh Subfunction OBh 


INTERRUPT 2Fh - Function 12h, Subfunction 24h 
internal - DELAY 


Purpose: Initiate a time delay, unless in a server call (INT 21h Function 5Dh Subfunction 00h), in order to wait 
before retrying a failed SHARE operation. 


Available on: DOS 3.0 or higher. Restrictions: none. 
Registers at call: Return Registers: n/a 
AX = 1224h 

SS = DOS DS 


Details: The delay is dependent on the processor speed, and is skipped entirely if inside a server call. 
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Conflicts: None known, 
See Also: INT 21h Function 44h Subfunction OBh, INT 21h Function 52h 


INTERRUPT 2Fh - Function 12h, Subfunction 25h 
internal - GET LENGTH OF ASCIZ STRING 


Purpose: Determine the length of a null-terminated string. 


Available on: DOS 3.0 or higher. Restrictions: none. 
Registers at call: Return Registers: 
AX = 1225h CX = length of string 


DS:SI -> ASCIZ string 
Conflicts: None known. 
See Also: Function 12h Subfunction 12h 


INTERRUPT 2Fh - Function 12h, Subfunction 26h 
internal - OPEN FILE 


Purpose: Open the specified file without going through the INT 21h dispatch routine. 


Available on: DOS 3.3 or higher. Restrictions: Can only be called from within DOS 
(assumes SS=DOS DS). 

Registers at call: Return Registers: 

AX = 1226h CF set on error 

CL = access mode AL = error code (see INT 21h Function 59h) 

DS:DX -> ASCIZ filename CF clear if successful 


AX = file handle 


Details: Equivalent to INT 21h Function 3Dh. 
Conflicts: None known. 
See Also: Function 12h Subfunction 27h, INT 21h Function 3Dh 


INTERRUPT 2Fh - Function 12h, Subfunction 27h 


internal - CLOSE FILE 
Purpose: Close the specified file without going through the INT 21h dispatch routine. 
Available on: DOS 3.3 or higher. Restrictions: Can only be called from within DOS 
(assumes SS=DOS DS). 
Registers at call: Return Registers: 
AX = 1227h CF set on error 
BX = file handle AL = 06h invalid file handle 
CF clear if successful 


Details: Equivalent to INT 21h Function 3Eh. 
Conflicts: None known. 
See Also: Function 11h Subfunction 06h, Function 12h Subfunctions 01h and 26h, INT 21h Function 3Eh 


INTERRUPT 2Fh - Function 12h, Subfunction 28h 
internal - MOVE FILE POINTER 


Purpose: Change position within a file without going through the INT 21h dispatch routine. 


Available on: DOS 3.3 or higher. Restrictions: May only be called from inside a DOS 
function call. 
Registers at call: Return Registers: as for INT 21h Function 42h 
AX = 1228h 
BP = 4200h, 4201h, 4202h (see INT 2[h Function 
42h) 


BX = file handle 
CX:DX = offset in bytes 
SS = DOS DS 
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Details: Equivalent to INT 21h Function 42h. Sets user stack frame pointer to dummy buffer, moves BP to AX, 
performs LSEEK, and restores frame pointer. 

Conflicts: None known. 

See Also: INT 21h Function 42h 


INTERRUPT 2Fh - Function 12h, Subfunction 29h 
internal - READ FROM FILE 


Purpose: Read from the specified file without going through the INT 21h dispatch routine. 


Available on: DOS 3.3 or higher. Restrictions: May only be called when already inside 
a DOS function call. 

Registers at call: Return Registers: as for INT 21h Function 3Fh 

AX = 1229h 


BX = file handle 

CX = number of bytes to read 

DS:DX -> buffer 

SS = DOS DS 

Details: Equivalent to INT 21h Function 3Fh. 

Conflicts: None known. 

See Also: Function 12h Subfunction 26h, INT 21h Function 3Fh 


INTERRUPT 2Fh - Function 12h, Subfunction 2Ah 
internal - SET FASTOPEN ENTRY POINT 


Purpose: Sets entry point for FASTOPEN routines. 


Available on: DOS 3.3 or higher. Restrictions: none. 
Registers at call: Return Registers: 
AX = 122Ah CF set if specified entry point already set 


BX = entry point to set (0001h or 0002h) 
S:SI -> FASTOPEN entry point (entry point not set 
if SI = FFFFh for DOS 4+) 
Details: The entry point in BX is ignored under DOS 3.30. Both entry points are set to the same handler by DOS 
4.01 FASTOPEN. 
Conflicts: None known. 


DOS 3.30 FASTOPEN is called with: 

AL =01h unknown. 
CX = unknown. seems to be an offset 
DI = unknown. seems to be an offset 
SI = offset in DOS DS of filename 

AL = 02h unknown. 

AL = 03h open file (calls function 01h first) 
SI = offset in DOS DS of filename 

AL = 04h unknown. 

AH = subfunction (00h, 01h, 02h) 

ES:DI -> unknown. 

CX = unknown. (subfunctions 01h and 02h only) 


Return Registers: 
CF set on error or not installed 


PCDOS 4.01 FASTOPEN is additionally called with: 
AL = 04h unknown. 
AH = 03h unknown. 
AL = 05h unknown. 
AL = OBh unknown. 
AL = 0Ch unknown. 
AL = ODh unknown, 
AL = OEh unknown, 
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AL = OFh unknown. 
AL = 10h unknown, 


INTERRUPT 2Fh - Function 12h, Subfunction 2Bh 
internal - lOCTL 
Purpose: Perform IOCTL driver actions without going through INT 21h dispatch routine. 
Available on: DOS 3.3 or higher. Restrictions: May only be called when already inside 
a DOS function call. 
Registers at call: Return Registers: as for INT 21h Function 44h 
AX = 122Bh 
BP = 44xxh 
SS = DOS DS 
additional registers as appropriate for INT 21h 
Function 44h 
Details: Equivalent to INT 21h Function 44h, Sets user stack frame pointer to dummy buffer, moves BP to AX, 
performs IOCTL, and restores frame pointer. 
Conflicts: None known, 
See Also: INT 21h Function 44h 


INTERRUPT 2Fh - Function 12h, Subfunction 2Ch 
internal - GET DEVICE DRIVER CHAIN 


Purpose: Locate first non-NUL device driver. 


Available on: DOS 3.3 or higher. Restrictions: none. 
Registers at call: Return Registers: 
AX = 122Ch BX:AX -> header of second device driver (NUL is the 


first) in driver chain 
Conflicts: None known. 
See Also: INT 21h Function 52h 


INTERRUPT 2Fh - Function 12h, Subfunction 2Dh 
internal - GET EXTENDED ERROR CODE 


Purpose: Obtain most recent extended error code. 


Available on: DOS 3.3 or higher. Restrictions: none. 
Registers at call: Return Registers: 
AX = 122Dh AX = current extended error code 


Conflicts: None known. 
See Also: Function 12h Subfunction 22h, INT 21h Function 59h 


INTERRUPT 2Fh - Function 12h, Subfunction 2Eh 
internal - GET OR SET ERROR TABLE ADDRESSES 


Purpose: Retrieve or replace various error tables. 


Available on: DOS 4.0 or higher. Restrictions: none. 
Registers at call: Return Registers: 
AX = 122Eh 
DL = subfunction: 
00h get standard DOS error table ES:DI -> error table (Tables 8-86 thru 8-88) 


(errors 0Oh-12h,50h-5Bh) 
Olh set standard DOS error table 

ES:D] -> error table 
02h get parameter error table (errors OOh-OAh) ES:DI -> error table 
03h set parameter error table 

ES:DI -> error table 
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04h get critical/SHARE error table ES:DI -> error table 
(errors 13h-2Bh) 
O5h set critical/SHARE error table 
ES:DI -> error table 
06h get unknown error table ES:DI -> error table 
O7h set unknown error table 
ES:DI -> error table 
O8h get error retrieval function ES:DI -> FAR retrieval function 
O9h set unknown error table 
ES:DI -> error table 
Details: If the returned segment on a “get” is O0OIh, then the offset specifies the offset of the error message table 
within COMMAND.COM, and the routine returned by subfunction 08h should be called to get the address of the 
error message. 
DOS 5.0 COMMAND.COM does not allow setting any of the addresses; they are always returned with segment 
0001h. 
Conflicts: None known. 
See Also: INT 2Fh Function 05h Subfunction 00h, INT 21h Function 59h 


Table 8-86. Format of DOS 4.x error table: 


Offset Size Description 

00h BYTE FFh 

Oth 2BYTEs  04h,00h (possibly DOS version) 
03h BYTE number of error headers following 
04h 2N WORDs table of all error headers for table 


Table 8-87. Format of each header: 


Offset Size Description 
00h WORD error message number 
02h WORD offset of error message from start of header; error messages consist of a count byte 


followed by actual message text 


Table 8-88. Format of DOS 5.0 error table: 


Offset Size Description 
00h N WORDs array of words (one per error number) containing either the offset of a counted string or 
0000h (invalid error number). 


Call error retrieval function with: 
AX = error number 
DI = offset of error table 


Return: 
ES:DI -> error message (counted string) 
Note: This function needs to access COMMAND.COM if the messages were not loaded into memory permanently 
with the /MSG switch; the caller should assume that the returned message will be overwritten by the next call to the 
retrieval function. 


INTERRUPT 2Fh - Function 12h, Subfunction 2Fh 
internal - SET DOS VERSION NUMBER TO RETURN 


Purpose: Permits DOS to lie about version, for compatibility with older programs. 
Available on: DOS 4.0 or higher. Restrictions: none. 
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Registers at call: Return Registers: n/a 
AX = 122Fh 
DX = DOS version number 
(0000h = return true DOS version) 
Conflicts: None known, 


INTERRUPT 2Fh - Function 46h, Subfunction 01h 


internal - Unknown Function 
Purpose: unknown. 


Available on: DOS 5.0 or higher. Restrictions: unknown. 

Registers at call: Return Registers: unknown. 

AX = 460th 

Details: This functions appears to copy the MCB following the caller's PSP memory block into the DOS data 
segment. 


Conflicts: None known. 
See Also: Function 46h Subfunction 02h 


INTERRUPT 2Fh - Function 46h, Subfunction 02h 


internal - Unknown Function 
Purpose: unknown. 


Available on: DOS 5.0 or higher. Restrictions: unknown, 

Registers at call; Return Registers: unknown. 

AX = 4602h 

Details: Appears to copy a previously saved MCB from the DOS data segment into the MCB following the caller's 
PSP memory block. 


Conflicts: None known, 
See Also: Function 46h Subfunction 01h 


DOSKEY 

DOS 5.0 introduced a commandline recall and editing utility as a separate program. Unlike the similar utilities 
which have been available from third parties for years, DOSKEY does not replace INT 21h Function OAh, and thus 
works only which programs which are aware of its existence, 


INTERRUPT 2Fh - Function 48h, Subfunction 00h 


INSTALLATION CHECK 

Purpose: Determine whether DOSKEY is installed. 

Available on: DOS 5.0 or higher. Restrictions: none. 
Registers at call: Return Registers: 

AX = 4800h AL = nonzero if installed 


Conflicts: None known. 
See Also: Function 48h Subfunction 10h 


INTERRUPT 2Fh - Function 48h, Subfunction 10h 
READ INPUT LINE FROM CONSOLE 


Purpose: Get a line of input from the user, who may recall and edit previously-input lines. 


Available on: DOS 5.0 or higher. Restrictions: DOSKEY must be installed. 
Registers at call: Return Registers: 
AX = 4810h AX = 0000h if successful 


DS:DX -> line buffer (see INT 21/AH=0Ah) 

Details: The first byte (length) of the buffer MUST be 80h, or DOSKEY chains to the previous handler. 

If the user's input is a macro name, no text is placed in the buffer even though AX=0000h on return; the program 
must immediately issue this call again to retrieve the expansion of the macro, Similarly, if the user enters a special 
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parameter such as $*, this call must be repeated to retrieve the expansion; on the second call, DOSKEY overwrites 
the macro name on the screen with its expansion. 

Conflicts: None known. 

See Also: Function 48h Subfunction 00h, INT 21h Function OAh 


DOSSHELL 
DOSSHELL is the text-mode/graphics shell included with MSDOS version 5.0. In addition to the call shown here, 
DOSSHELL implements the task switcher interface, which is listed in a separate section below. 

The shell of the same name included with DOS 4.x does not provide an API itself, although one of its 
components, SHELLB, does; SHELLB is described in a separate section below. 


INTERRUPT 2Fh - Function 4Ah, Subfunction 05h 
Unknown Function 


Purpose: Access a number of unknown functions within the shell. 
Available on: DOS 5.0 or higher. Restrictions: DOSSHELL must be active. 
Registers at call: Return Registers: unknown. 
AX =4A05h 
SI = function 
0000h reser 
0001h unknown. 
0002h unknown. 
0003h unknown. 


0004h unknown, 
BL = unknown. 


0005K unknown. 
0006h get unknown value ES:DI -> unknown. 
0007h get unknown value AX = unknown. 
0008h get unknown value DX:AX -> unknown. 
0009h get unknown value 
O00Ah unknown. 
BL = unknown. 
ES:DI -> unknown. 
0O0Bh get unknown value AX = unknown, 
000Ch unknown. DX:AX -> unknown, 
BL = unknown. 
Details: DOSSHELL chains to the previous handler if SI is not one of the values listed above. 


Conflicts: None known. 
See Also: Function 4Bh Subfunction 02h 


| 
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DRIVER.SYS SUPPORT 

DOS version 3.3 introduced the DRIVER.SYS driver to allow the use of nonstandard disk formats. To support this 
driver, the hardware-dependent portion of MSDOS (IO.SYS/IBMBIO.COM) provides a number of services on 
multiplex number 08h. 


INTERRUPT 2Fh - Function 08h, Subfunction 00h 


INSTALLATION CHECK 

Purpose: Determine whether DRIVER.SYS support is available. 

Available on: DOS 3.3 or higher. Restrictions: none. 

Registers at call: Return Registers: 

AX = 0800h AL = 00h not installed, OK to install 


Olh not installed, not OK to install 
FFh installed 
Conflicts: None known. 


INTERRUPT 2Fh - Function 08h, Subfunction 01h 
ADD NEW BLOCK DEVICE 


Purpose: Moves down internal list of drive data tables, copying and modifying the drive description flags word for 
tables referencing same physical drive. 


Available on: DOS 3.3 or higher. Restrictions: none. 
Registers at call: Return Registers: n/a 
AX = 0801h 


DS:DI -> drive data table (see Subfunction 03h) 
Details: Data table appended to chain of tables. 
Conflicts: None known. 

See Also: Function 08h Subfunction 03h 


INTERRUPT 2Fh - Function 08h, Subfunction 02h 
EXECUTE DEVICE DRIVER REQUEST 


Purpose: Pass driver request packet to diver. 


Available on: DOS 3.3 or higher. Restrictions: none. 
Registers at call: Return Registers: 
AX = 0802h request header updated as per requested operation 


ES:BX -> device driver request header (Table 8-89) 
Conflicts: None known. 


Table 8-89, Format of device driver request header: 


Offset Size Description 

00h BYTE length of request header 

Oth BYTE subunit within device driver 

02h BYTE command code (see Table 8-90) 
03h WORD status (filled in by device driver): 


bit 15; error 
bits 14-10: reserved 


bit 9: busy 

bit 8: done 

bits 7-0: error code if bit 15 set (see Table 8-91) 
--DOS 
05h 8BYTEs reserved (unused in DOS 2.x and 3.x) 
--STARLITE architecture 
05h DWORD pointer to next request header 


09h 4BYTEs reserved 
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Table 8-89. Format of device driver request header (continued) 


Description 


number of units (set by driver) 

address of first free byte following driver (set by driver) 
pointer to BPB array (set by block drivers only) 

(DOS 3+) drive number for first unit of block driver (0=A) 


media descriptor 
retumed status: 
00h don't know 
01h media has not changed 
FFh media has been changed 
(DOS 3+) pointer to previous volume ID if OPEN/ CLOSE/ RM bit in device header set 
and disk changed (set by driver) 


media descriptor 

transfer address 
-> scratch sector if NON-IBM FORMAT bit in device header set 
-> first FAT sector otherwise 

pointer to BPB (set by driver) 


media descriptor (block devices only) 

transfer address 

byte count (character devices) or sector count (block devices) 
starting sector number (block devices only) 


media descriptor (block devices only) 

transfer address 

byte count (character devices) or sector count (block devices) 

starting sector number (block devices only) 

(DOS 3+) pointer to volume ID if error OFh returned 

(DOS 4+) 32-bit starting sector number (block devices with attribute 
bit 1 set only) (see INT 21h Function 52h) 


Offset Size 
-~command code 00h 
ODh BYTE 
OEh DWORD 
12h DWORD 
16h BYTE 
--command code 01h 
ODh BYTE 
OEh BYTE 
OFh DWORD 
---command code 02h 
ODh BYTE 
OEh DWORD 
12h DWORD 
--command codes 03h,0Ch 
0Dh BYTE 
OEh DWORD 
12h WORD 
14h WORD 
---command codes 04h,08h,09h 
ODh BYTE 
OEh DWORD 
12h WORD 
14h WORD 
16h DWORD 
1Ah DWORD 
--command code 05h 
ODh BYTE 


byte read from device if BUSY bit clear on return 


-~-command codes 06h,07h,0Ah,OBh,0Dh, OEh,0Fh 
no further fields 


---command code 10h 


ODh BYTE 
OEh DWORD 
12h WORD 
---command code 13h 
ODh BYTE 
OEh BYTE 
OFh WORD 
ith WORD 
13h DWORD 


unused 
transfer address 
byte count 


category code: 

00h unknown 

01h COMn: 

03h CON 

05h LPTn: 

O8h disk 

9Eh (STARLITE) Media Access Control driver 

function code: 

00h (STARLITE) MAC Bind request 

copy of DS at time of IOCTL cali (apparently unused in DOS 3.3) 
offset of device driver header 

pointer to parameter block from INT 21h Function 44h Subfunction ODh 


Table 8-90. Values for command code: 


Value 
00h 
Olh 
02h 
03h 
04h 
05h 


06h 
07h 
08h 
09h 
OAh 
OBh 
0Ch 
0Dh 
OEh 
OFh 


10h 


Command 

INIT 

MEDIA CHECK (block devices) 

BUILD BPB (block devices) 

JOCTL INPUT 

INPUT 

NONDESTRUCTIVE INPUT, NO WAIT 
(character devices) 

INPUT STATUS (character devices) 

INPUT FLUSH (character devices) 

OUTPUT 

OUTPUT WITH VERIFY 

OUTPUT STATUS (character devices) 

OUTPUT FLUSH (character devices) 

IOCTL OUTPUT 

(DOS 3+) DEVICE OPEN 

(DOS 3+) DEVICE CLOSE 

(DOS 3+) REMOVABLE MEDIA 
(block devices) 

(DOS 3+) OUTPUT UNTIL BUSY 
(character devices) 


Table 8-91. Values for error code: 


Value 
00h 
Olh 
02h 
03h 
04h 
05h 
06h 
07h 


INTERRUPT 2Fh - Function 08h, Subfunction 03h 


Error 

write-protect violation 

unknown unit 

drive not ready 

unknown command 

CRC error 

bad drive request structure length 
seek error 

unknown media 


GET DRIVE DATA TABLE LIST 


Purpose: Obtain far pointer to first drive data table. 
Available on: DOS 4.0 or higher, 


Registers at 
AX = 0803h 


call: 


Conflicts: None known. 
See Also: Function 08h Subfunction O1h 


Table 8-92. Format of DOS 3.30 drive data table: 


Offset 
00h 
04h 
05h 
06h 
19h 


1Ah 
1Ch 
27h 
28h 


Size Description 
DWORD pointer to next table 


BYTE physical unit number (for INT 13h) 


BYTE logical drive number 
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Command 

unused 

unused 

(DOS 3.2+) GENERIC IOCTL 
unused 

unused 

unused 

(DOS 3.2+) GET LOGICAL DEVICE 
(DOS 3.2+) SET LOGICAL DEVICE 
(DOS 5+) GENERIC IOCTL CHECK 
(CD-ROM) READ LONG 
(CD-ROM) reserved 

(CD-ROM) READ LONG PREFETCH 
(CD-ROM) SEEK 

(CD-ROM) PLAY AUDIO 
(CD-ROM) STOP AUDIO 
(CD-ROM) WRITE LONG 
(CD-ROM) WRITE LONG VERIFY 
(CD-ROM) RESUME AUDIO 


Error 

sector not found 
printer out of paper 
write fault 

read fault 

general failure 
reserved 

reserved 

invalid disk change 


Restrictions: none. 
Return Registers: 
DS:DI -> first drive data table (Table 8-92) in list 


19 BYTEs BIOS Parameter Block (see also INT 21h Function 53h) 


BYTE flags 


bit 6: 16-bit FAT instead of 12-bit FAT 


WORD 
11BYTEs volume label or "NO NAME 


number of DEVICE OPEN calls without corresponding DEVICE CLOSE 
" if none (always "NO NAME" for fixed media) 
BYTE terminating null for volume label 


BYTE device type (see INT 21h Function 44h Subfunction 0Dh) 
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Table 8-92. Format of DOS 3.30 drive data table (continued) 


Offset Size 

29h WORD 
2Bh WORD 
2Dh 19 BYTEs 
40h 3 BYTEs 
43h 9 BYTEs 
4Ch BYTE 
--removable media 

4Dh DWORD 
---fixed media 

4Dh WORD 
4Fh WORD 


Description 

bit flags describing drive: 

bit 0: fixed media 

bit 1: door lock supported 

bit 2: unknown. (used in determining BPB to set for INT 21h Function 44h Subfunction 
ODh) 

bit 3: all sectors in a track are the same size 

bit 4: physical drive has multiple logical units 

bit 5: current logical drive for physical drive 

bit 6: unknown. 

bit 7: unknown. 

bit 8: unknown. (related to disk change detection) 

number of cylinders 

BIOS Parameter Block for highest capacity supported 

unknown, 

filesystem type, default = "NO NAME__" (apparently only MSDOS 3.30 fixed media, nulls 
for removable media and PCDOS 3.30) 

least-significant byte of last-accessed cylinder number 


time of last access in clock ticks (FFFFFFFFh if never) 


partition (FFFFh = primary, 0001h = extended) 
absolute cylinder number of partition's start on physical drive (always FFFFh if 
primary partition) 


Table 8-93. Format of BIOS Parameter Block for DOS 3.30: 


Offset 


Size 
WORD 
BYTE 
WORD 
BYTE 
WORD 
WORD 
BYTE 
WORD 
WORD 
WORD 
WORD 


Description 

bytes per sector 

sectors per cluster, FFh if unknown 
number of reserved sectors 
number of FATs 

number of root dir entries 

total sectors 

media descriptor, 00h if unknown 
sectors per FAT 

sectors per track 

number of heads 

number of hidden sectors 


Table 8-94. Format of COMPAQ DOS 3.31 drive data table: 


Offset 
00h 
04h 
05h 
06h 
1Fh 
25h 





Size 
DWORD 
BYTE 
BYTE 

25 BYTEs 
6 BYTEs 
BYTE 


WORD 

11 BYTEs 
BYTE 
BYTE 
WORD 


Description 
pointer to next table 
physical unit number (for INT 13h) 
logical drive number 
BIOS Parameter Block (see DOS 4.01 drive data, Table 8-95) 
unknown, apparently always zeros 
flags: 
bit 6: 16-bit FAT instead of 12-bit FAT 
5: large volume 
device-open count 
volume label or "NO NAME __ " if none (always "NO NAME" for fixed media) 
terminating null for volume label 
device type (see INT 21h Function 44h Subfunction ODh) 
bit flags describing drive 
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Table 8-94, Format of COMPAQ DOS 3.31 drive data table (continued) 


Description 

number of cylinders 

BIOS parameter block for highest capacity drive supports 
unknown, apparently always zeros 

least-significant byte of last-accessed cylinder number 


time of last access in clock ticks (FFFFFFFFh if never) 


partition (RFFFh = primary, 0001h = extended) 


absolute cylinder number of partition’s start on physical drive (always FFFFh if 


primary partition) 


Table 8-95. Format of DOS 4.0-5.0 drive data table: 





Offset Size 

37h WORD 
39h 25 BYTEs 
52h 6 BYTEs 
38h BYTE 
--removable media 

59h DWORD 
---fixed media 

59h WORD 
SBh WORD 
Offset Size 

00h DWORD 
04h BYTE 
OSh BYTE 
06h 25 BYTEs 
IFh BYTE 
20h 2 BYTEs 
22h BYTE 
23h WORD 
25h WORD 
27h 25 BYTEs 
40h 7 BYTEs 
47h DWORD 
4Bh 11 BYTEs 
56h BYTE 
57h DWORD 
SBh 8 BYTEs 
63h BYTE 


Description 

pointer to next table 

physical unit number (for INT 13h) 

logical drive number 

BIOS Parameter Block (see also INT 21h Function 53h) 
flags: 

bit 6: 16-bit FAT instead of 12-bit 

unknown. 

device type (see INT 21h Function 44h Subfunction ODh) 
bit flags describing drive: 

bit 0: fixed media 

bit I: door lock supported 

bit 2: unknown. 

bit 3: all sectors in a track are the same size 

bit 4: physical drive has multiple logical units 

bit 5: current logical drive for physical drive 

bit 6: unknown. 

bit 7: unknown. 

bit 8: unknown. 

number of cylinders 

BIOS Parameter Block for highest capacity supported 
unknown. 

time of last access in clock ticks (FFFFFFFFh if never) 
volume label or "NO NAME_ " if none 

terminating null for volume label 

serial number 

filesystem type ("FAT12 "or "FATI6 ") 
terminating null for filesystem type 


Table 8-96. Format of BIOS Parameter Block for DOS 4.0-5.0: 


Offset Size 
00h WORD 
02h BYTE 
03h WORD 
05h BYTE 
06h WORD 
08h WORD 
OAh BYTE 
OBh WORD 
ODh WORD 


OFh WORD 


Description 

bytes per sector 

sectors per cluster, FFh if unknown 
number of reserved sectors 
number of FATs 

number of root dir entries 

total sectors (see offset 15h if zero) 
media descriptor, 00h if unknown 
sectors per FAT 

sectors per track 

number of heads 


8-123 





| 
| 
| 
| 





8-124 MS-DOS and Compatibles 


Table 8-96. Format of BIOS Parameter Block for DOS 4.0-5.0 (continued) 


Offset Size Description 

ith DWORD number of hidden sectors 

15h DWORD total sectors if WORD at 08h is zero 
EGA.SYS 


One limitation of the EGA in task-swapping and multitasking environments is its write-only registers. The EGA 
Register Interface Library described in chapter 5 provides a fairly standard method for programs to program the 
EGA's registers while still allowing the swapper or multitasker to maintain separate states for each program. 
EGA.SYS is one particular implementation of the Register Interface Library. 


INTERRUPT 2Fh - Function BCh, Subfunction 00h 


INSTALLATION CHECK 
Purpose: Determine whether the EGA.SYS driver for Windows 3.0 or DOS 5.0 is installed. 
Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AX = BCOOh AL = 00h not installed, OK to install 
= 01h not installed, not OK to install 
= FFh installed 


BX = 5456h ("TV") 
Details: BCh is the default multiplex number, which may be changed by a command line parameter to any value 
between 80h and FFh, 
Conflicts: None known, 
See Also: Function BCh Subfunction 06h, EGA Register Interface Library INT 10h Function FAh (chapter 5) 


INTERRUPT 2Fh - Function BCh, Subfunction 06h 
GET VERSION INFORMATION 


Purpose: Determine which version of EGA.SYS is installed. 


Available on: All machines. Restrictions: Windows 3.0 or DOS 5.0 EGA.SYS 
must be installed, 

Registers at call: Return Registers: 

AX = BCO6h BX = 5456h ("TV") 


CH = major version 
CL = minor version 
DL = revision 
Conflicts: None known. 
See Also: Function BCh Subfunction 00h, EGA Register Interface Library INT 10h Function FAh (chapter 5) 


GRAFTABL.COM 
INTERRUPT 2Fh - Function BOh, Subfunction 00h 


INSTALLATION CHECK 

Purpose: Determine whether GRAFTABL is installed. 

Available on: DOS 3.3 or higher, Restrictions: none. 

Registers at call: Return Registers: 

AX = BOOOh AL = 00h not installed, OK to install 
= 01h not installed, not OK to install 
= FFh installed 


Details: Called by DISPLAY.SYS. 
Conflicts: None known. 
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INTERRUPT 2Fh - Function BOh, Subfunction 0th 
GET ADDRESS OF GRAPHICS FONT TABLE 


Purpose: unknown. 


Available on: DOS 3.3 or higher. Restrictions: GRAFTABL must be installed. 
Registers at call: Return Registers: 
AX = BOOIh buffer filled 
DS:DX -> DWORD buffer for address of 8x8 font AL =FPFh 

table 
Conflicts: None known, 
GRAPHICS.COM 
INTERRUPT 2Fh - Function 15h, Subfunction 00h 
INSTALLATION CHECK 
Purpose: Determine whether GRAPHICS.COM is installed, 
Available on: DOS 4.00 only. Restrictions: none. 
Registers at call: Return Registers: 
AX = 1500h AX = FFFFh 


ES:DI -> unknown. (possibly graphics data) 
Details: This installation check conflicts with the CDROM Extensions installation check; moved to Function ACh 
Subfunction 00h in later versions. 
Conflicts: CDROM Installation Check (chapter 19). 
See Also: Function ACh Subfunction 00h 


INTERRUPT 2Fh - Function ACh, Subfunction 00h 


INSTALLATION CHECK 

Purpose: Determine whether GRAPHICS.COM is installed. 

Available on: DOS 4.01 or higher. Restrictions: none. 
Registers at call: Return Registers: 
AX = AC00h AX = FFFFh 


ES:DI -> unknown. (possibly graphics data) 

Details: This installation check was moved here to avoid the conflict with the CDROM extensions that occurred in 
DOS 4.00. 

Conflicts: None known. 

See Also: GRAPHICS.COM Function [5h Subfunction 00h 


HMA 

The High Memory Area is an unusual 64K-16 bytes of memory available on 80286 and higher processors, While 
technically extended memory because it lies beyond the 1 megabyte limit of the 8086's address space, it is still 
accessible from real mode. Chapter 10 includes more calls related to the HMA under the Extended Memory 
Specification (XMS). 


INTERRUPT 2Fh - Function 4Ah, Subfunction 01h 





QUERY FREE HMA SPACE 

Purpose: Determine how much, if any, space in the high memory area at segment FFFFh is still unused, 

Available on; DOS 5.0 or higher. Restrictions: none. 

Registers at call: Return Registers: 

AX =4A0th BX = number of bytes available in HMA (0000h if 
DOS not using HMA) 

ES:DI -> start of available HMA area (FFFFh:FFFFh if 

not using HMA) 


Conflicts: None known. 


8-126 MS-DOS and Compatibles 


See Also: Function 4Ah Subfunction 02h, XMS Function 43h Subfunction 10h (chapter 10) 
INTERRUPT 2Fh - Function 4Ah, Subfunction 02h 


ALLOCATE HMA SPACE 

Purpose: Reserve a portion of the High Memory Area. 

Available on: DOS 5.0 or higher, Restrictions; DOS must be loaded into the HMA 
(DOS=HIGH). 

Registers at call: Return Registers: 

AX = 4A02h ES:DI -> start of allocated HMA block or 

BX = number of bytes FFFFh:FFFFh 


BX destroyed 
Conflicts: None known. 
See Also: Function 4Ah Subfunction 01h 


IFSFUNC.EXE 

Although included on the DOS system disk, IFSFUNC is described separately, in chapter 19, as it implements the 
network redirector. IFSFUNC was included with DOS 4.x in an attempt to allow network vendors to provide 
version-independent redirectors; however, IFSFUNC suffered from performance problems due to the additional layer 
of software, and has been dropped with MSDOS version 5. The DOS 5 kernel still uses the same calls, but they are 
now once again implemented by version-dependent network redirectors. 


INSTALLABLE COMMAND 


INTERRUPT 2Fh - Function AEh, Subfunction 00h 
internal - INSTALLABLE COMMAND - INSTALL CHECK 


Purpose: Determine whether code for a particular installable command is present. 


Available on: DOS 3.3 or higher. Restrictions: none. 

Registers at call: Return Registers: 

AX = AEQOh AL = FFh if this command is a TSR extension to 

DX = FFFFh COMMAND.COM 

DS:BX -> command line (Table 8-97) AL = 00h if the command should be executed as usual 


Details: This call provides a mechanism for TSRs to install permanent extensions to the command repertoire of 
COMMAND.COM. It appears that COMMAND.COM makes this call before executing the current command line, 
and does not execute it itself if the return is FFh. APPEND hooks this call, to allow subsequent APPEND commands 
to execute without re-running APPEND. CH appears to be set to FFh on the first call and 00h on the second. 
Conflicts: None known. 


Table 8-97. Format of command line: 


Offset Size Description 
00h BYTE max length of command line, as in INT 21h Function OAh 
Oth BYTE count of bytes to follow 


NBYTEs command line text, terminated by ODh 


INTERRUPT 2Fh - Function AEh, Subfunction 01h 
internal - INSTALLABLE COMMAND - EXECUTE 


Purpose: Requests execution of the command which a previous call to Function AEh Subfunction 00h indicated was 

resident. 

Available on: DOS 3.3 or higher. Restrictions: Installable Command routines must be 
installed, 
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Registers at call: Return Registers: 

AX = AEOIh Buffer at DS:SI filled with a length byte followed by 
DX = FFFFh the uppercase internal command to execute (if 
DS:SI -> buffer length not 0). 


Details: APPEND hooks this call. If the buffer is filled with a nonempty string, COMMAND.COM will attempt to 
execute it as an internal command. 
Conflicts: None known. 


KEYB.COM 


INTERRUPT 2Fh - Function ADh, Subfunction 80h 

INSTALLATION CHECK 

Purpose: Determine whether KEYB.COM is installed. 

Available on: DOS 3.3 or higher. Restrictions: none. 

Registers at call: Return Registers: 

AX = AD80h AL = FFh if installed 
BX = version (BH = major, BL = minor) 
ES:DI -> internal data (Table 8-98) 

Details: Newly documented for DOS 5.0 although present since 3.3. 

Conflicts: None known. 

See Also: Function ADh Subfunction 8th 


Table 8-98. Format of KEYB internal data: 


Offset Size Description 

00h DWORD original INT 09h 

04h DWORD _ original INT 2Fh 

O8h 6BYTEs unknown, 

OEh WORD flags 

10h BYTE unknown, 

ih BYTE unknown. 

12h 4BYTEs unknown. 

16h 2BYTEs country ID letters 

18h WORD current code page 
~-DOS 3.3 

1Ah WORD pointer to first item in list of code page tables (Table 8-99) 
1Ch WORD pointer to unknown item in list of code page tables (Table 8-99) 
1Eh 2BYTEs — unknown. 

20h WORD pointer to key translation data (Table 8-100) 

22h WORD pointer to last item in code page table list (Table 8-99) 
24h 9BYTEs unknown. 
--DOS 4.01 

1Ah 2BYTEs unknown. 

1Ch WORD pointer to first item in list of code page tables (Table 8-99) 
1Eh WORD pointer to unknown item in list of code page tables (Table 8-99) 
20h 2BYTEs = unknown. 

22h WORD pointer to key translation data (Table 8-100) 

24h WORD pointer to last item in code page table list (Table 8-99) 
26h 9BYTEs unknown. 


Table 8-99. Format of code page table list entries: 


Offset Size Description 
00h WORD pointer to next item, FFFFh = last 
02h WORD code page 


04h 2BYTEs unknown. 
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Table 8-100. Format of translation data: 


Offset Size Description 

00h WORD size of data in bytes, including this word 

02h N-2 BYTEs unknown. 

INTERRUPT 2Fh - Function ADh, Subfunction 81h 

SET KEYBOARD CODE PAGE 

Purpose: Establish translation set for keyboard. 

Available on: DOS 3.3 or higher. Restrictions: KEYB.COM must be installed, 

Registers at call: Return Registers: 

AX = AD81h CF set on error 

BX = code page AX = 0001h (code page not available) 
CF clear if successful 


Details: Called by DISPLAY.SYS. Newly documented for DOS 5.0 although present since 3.3. 
Conflicts: None known. 
See Also: Function ADh Subfunction 82h 


INTERRUPT 2Fh - Function ADh, Subfunction 82h 
SET KEYBOARD MAPPING 


Purpose: Establish keyboard mapping. 


Available on: DOS 3.3 or higher. Restrictions: KEYB.COM must be installed. 
Registers at call: Return Registers: 

AX = AD82h CF set on error (BL not 00h or FFh) 

BL = 00h US keyboard (Control-Alt-F1) CF clear if successful 


= FFh foreign keyboard (Control-Alt-F2) 
Details: Newly documented for DOS 5.0 although present since 3.3. 
Conflicts: None known. 
See Also: Function ADh Subfunctions 81h and 83h 


INTERRUPT 2Fh - Function ADh, Subfunction 83h 
GET KEYBOARD MAPPING 


Purpose: Determine current keyboard mapping. 


Available on: DOS 5.0. Restrictions: KEYB.COM must be installed. 
Registers at call: Return Registers: 
AX = AD83h BL = 00h US keyboard (Control-Alt-F1) 


= FFh foreign keyboard (Control-Alt-F2) 
Conflicts: None known, 
See Also: Function ADh Subfunction 82h 


NLSFUNC.COM 


INTERRUPT 2Fh - Function 14h, Subfunction 00h 

INSTALLATION CHECK 

Purpose: Determine whether NLSFUNC.COM is installed. 

Available on: DOS 3.3 or higher. Restrictions: none. 

Registers at call: Return Registers: 

AX = 1400h AL = status 
00h not installed, OK to install 
O1h not installed, not OK. 
FFh installed 


Details: Called by DOS v3.3+ kernel. Supported by OS/2 v1.3+ compatibility box, which always returns AL=FFh. 


This function has been documented for DOS 5.0, but was undocumented in prior versions. 
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Conflicts: None known. 


INTERRUPT 2Fh - Function 14h, Subfunction 01h 


CHANGE CODE PAGE 

Purpose: Changes code page used by INT 21h Function 65h. 

Available on: DOS 3.3 or higher. Restrictions: NUSFUNC.COM must be installed, 
Registers at call: Return Registers: 

AX = 1401h AL = status 

DS:SI -> internal code page structure (Table 8-101) 00h successful 

BX = new code page else DOS error code 


DX = country code 

Details: Called by DOS v3.3+ kernel. 
Conflicts: None known. 

See Also: INT 21h Function 66h 


Table 8-101. Format of DOS 3.30 internal code page structure: 


Offset Size Description 

00h 8BYTEs unknown, 

08h 64 BYTEs name of country information file 

48h WORD system code page 

4Ah WORD number of supported subfunctions 

4Ch SBYTEs data to return for INT 21h Function 65h Subfunction 02h 
Sih SBYTEs data to return for INT 21h Function 65h Subfunction 04h 
56h SBYTEs data to return for INT 21h Function 65h Subfunction 05h 
SBh SBYTEs data to return for INT 21h Function 65h Subfunction 06h 
60h 41 BYTEs data to return for INT 21h Function 65h Subfunction 01h 


INTERRUPT 2Fh - Function 14h, Subfunction 02h 
GET COUNTRY INFORMATION 


Purpose: Obtain country information from code page. 


Available on: DOS 3.3 or higher. Restrictions: NLSFUNC.COM must be installed. 
Registers at call: Return Registers: 
AX = 1402h AL = status 
BP = subfunction (same as AL for INT 21h 00h successful 
Function 65h) else DOS error code 


BX = code page 
DX = country code 
DS:SI -> internal code page structure (see Function 
14h Subfunction 01h) 
ES:DI -> user buffer 
CX = size of user buffer 
Details: Called by DOS v3.3+ kernel on INT 21h Function 65h. The code page structure is apparently only needed 
for the COUNTRY.SYS pathname, 
Conflicts: None known. 
See Also: Function 14h Subfunction 03h, Function 14h Subfunction 04h, INT 21h Function 65h 


INTERRUPT 2Fh - Function 14h, Subfunction 03h 


SET COUNTRY INFORMATION 


Purpose: Sets country information into code page. 
Available on: DOS 3.3 or higher. Restrictions: NUSFUNC.COM must be installed. 
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Registers at call: Return Registers: 

AX = 1403h AL = status 

DS:SI -> internal code page structure (see Function values unknown. 
14h Subfunction 01h) 


BX = code page 

DX = country code 

Details: Called by DOS v3.3+ kernel on INT 21h Function 38h. 

Conflicts: None known. 

See Also: Function 14h Subfunction 02h, Function 14h Subfunction 04h, INT 21h Function 38h"SET" 


INTERRUPT 2Fh - Function 14h, Subfunction 04h 
GET COUNTRY INFORMATION 


Purpose: Obtain country information from code page. 


Available on: DOS 3.3 or higher. Restrictions: NLSFUNC.COM must be installed. 
Registers at call: Return Registers: 

AX = 1404h AL = status 

BX = code page other return values unknown. 


DX = country code 
DS:SI -> internal code page structure (see Function 
14h Subfunction 01h) 
ES:DI -> user buffer 
Details: Called by DOS v3.3+ kernel on INT 21h Function 38h. The code page structure is apparently only needed 
for the COUNTRY.SYS pathname. 
Conflicts: None known, 
See Also: Function 14h Subfunction 02h, Function 14h Subfunction 03h, INT 21h Function 38h"GET" 


PRINT.COM 


INTERRUPT 15h - Function 20h, Subfunction 00h 
DISABLE PRINT.COM CRITICAL REGION FLAG 


Purpose: Stop updating a user flag which indicates whether PRINT is currently making a DOS call. 


Available on: DOS 3.0 or higher. Restrictions: PRINT must be installed. 
Registers at call: Return Registers: n/a 
AX = 2000h 


Conflicts: None known. 
See Also: Function 20h Subfunction 01h 


INTERRUPT 15h - Function 20h, Subfunction 01h 
ENABLE PRINT.COM CRITICAL REGION FLAG 


Purpose: Begin updating a user flag whenever PRINT enters or leaves a DOS call. 


Available on: DOS 3.0 or higher. Restrictions; PRINT must be installed. 
Registers at call: Return Registers: n/a 
AX = 2001h 
ES:BX -> byte which is to be incremented while in 
a DOS call 


Conflicts: None known. 
See Also: Function 20h Subfunction 00h 


INTERRUPT 2Fh - Function 00h 


Unknown Function 


Purpose: unknown. 
Available on: DOS 2.x only. Restrictions: PRINT must be installed. 
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Registers at call: 
AH = 00h 
other unknown. 


Details: DOS 2.x PRINT does not chain to previous INT 2Fh handler. Values in AH other than 00h or O1h cause 


PRINT to return the number of files in the queue in AH. 
Conflicts: None known. 
See Also: Function 01h 


INTERRUPT 2Fh - Function 00h, Subfunction 80h 
GIVE PRINT A TIME SLICE 

Purpose: Forces time slice for PRINT. 

Available on: DOS 3.1 or higher. 

Registers at call: 

AX = 0080h 

Details: Returns after PRINT executes. 


INTERRUPT 2Fh - Function 01h 
Unknown Function 

Purpose: unknown, 

Available on: DOS 2.x only. 
Registers at call: 

AH =0lh 

other unknown. 


Details: DOS 2.x PRINT does not chain to previous INT 2Fh handler. Values in AH other than 00h or 01h cause 


PRINT to return the number of files in the queue in AH. 
Conflicts: None known. 
See Also: Function 00h 


INTERRUPT 2Fh - Function 01h, Subfunction 00h 
INSTALLATION CHECK 


Purpose: Determine whether PRINT is installed. 
Available on: DOS 3.0 or higher. 


Registers at call: 
AX =0100h 


Conflicts: None known. 
See Also: Function 01h Subfunction 01h 


INTERRUPT 2Fh - Function 01h, Subfunction 01h 
SUBMIT FILE FOR PRINTING 


Purpose: Place a file on the queue of files to be printed, 
Ayailable on: DOS 3.0 or higher. 
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Return Registers: unknown. 


Restrictions: PRINT must be installed. 
Return Registers: n/a 


Restrictions: PRINT must be installed. 
Return Registers: unknown. 


Restrictions; none. 

Return Registers: 

AL = status: 
00h not installed 
Olh not installed, but not OK to install 
FFh installed 


Restrictions: PRINT must be installed. 
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Registers at call: Return Registers: 
AX=0101h CF clear if successful 
DS:DX -> submit packet (Table 8-102) AL = 01h added to queue 


9Eh now printing 
CF set on error 
AX = error code (see also INT 21h Function 59h): 
Olh invalid function 


02h file not found 
03h path not found 
04h out of file handles 
O5h access denied 
O8h print queue full 
09h spooler busy 
OCh name too long 
OFh invalid drive 

Conflicts: None known. 

See Also: Function 01h Subfunction 02h 

Table 8-102. Format of submit packet: 

Offset Size Description 

00h BYTE level (must be 00h) 

Olh DWORD pointer to ASCIZ filename (no wildcards) 

INTERRUPT 2Fh - Function 01h, Subfunction 02h 

REMOVE FILE FROM PRINT QUEUE 

Purpose: Cancel the pending printing of a file. 

Available on: DOS 3.0 or higher. Restrictions: PRINT must be installed, 

Registers at call: Return Registers: 

AX =0102h CF clear if successful 

DS:DX -> ASCIZ filename (wildcards allowed) CF set on error 

AX = error code (see Function 01h Subfunction 

Olh) 


Conflicts: None known. 
See Also: Function 01h Subfunctions 01h and 03h 


INTERRUPT 2Fh - Function 01h, Subfunction 03h 
CANCEL ALL FILES IN PRINT QUEUE 


Purpose: Stop printing the current file and forget all other queued files. 


Available on: DOS 3.0 or higher. Restrictions: PRINT must be installed. 
Registers at call: Return Registers: 
AX =0103h CF clear if successful 


CF set on error 
AX = error code (see Function 01h Subfunction 
Olh) 
Conflicts: None known. 
See Also: Function 01h Subfunction 02h 


INTERRUPT 2Fh - Function 01h, Subfunction 04h 
FREEZE PRINT QUEUE TO READ JOB STATUS 


Purpose: Stop printing momentarily so that the print queue does not change during a status check. 
Available on: DOS 3.0 or higher. Restrictions: PRINT must be installed. 
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Registers at call: Return Registers: 
AX =0104h CF clear if successful 

DX = error count 

DS:SI -> print queue 

CF set on error 
AX = error code (see Function 01h Subfunction 
Oth) 

Details: The print queue is an array of 64-byte ASCIZ filenames terminated by an empty filename; the first name is 
the file currently being printed. Printing is stopped until Function 01h Subfunction 05h is called to prevent the queue 
from changing while the filenames are being read. 
Conflicts: None known. 
See Also: Function 01h Subfunction 01h, Function 01h Subfunction 05h 


INTERRUPT 2Fh - Function 01h, Subfunction 05h 
RESTART PRINT QUEUE AFTER STATUS READ 


Purpose: Resume printing after a temporary stop to prevent status changes. 


Available on: DOS 3.0 or higher. Restrictions: PRINT must be installed. 
Registers at call: Return Registers: 
AX =0105h CF clear if successful 


CF set on error 
AX = error code (see Function 01h Subfunction 


Olh) 
Conflicts; None known. 
See Also: Function 01h Subfunction 04h 
INTERRUPT 2Fh - Function 01h, Subfunction 06h 
GET PRINTER DEVICE 
Purpose: Determine whether there are any files in PRINT's queue, and if so, which device is being used for output. 
Available on: DOS 3.3 or higher. Restrictions: PRINT must be installed. 
Registers at call: Return Registers: 
AX =0106h CF set if files in print queue 


AX = error code 0008h (queue full) 
DS:SI -> device driver header 
CF clear if print queue empty 
AX = 0000h 
Details: This call has been documented for DOS 5.0, but was undocumented in prior versions, 
Conflicts: None known. 
See Also: Function 01h Subfunction 04h 


SHARE 


INTERRUPT 2Fh - Function 10h, Subfunction 00h 
INSTALLATION CHECK 
Purpose: Determine whether SHARE.EXE is installed. 
Available on: DOS 3.0 or higher. Restrictions: none. 
Registers at call: Return Registers: 
AX = 1000h AL = status 
00h not installed, OK to install 
Olh not installed, not OK to install 
FFh installed 
Details: Supported by OS/2 v1.3+ compatibility box, which always returns AL=FFh. 
BUGS: Values of AL other than 00h put DOS 3.x SHARE into an infinite loop (O8E9: OR AL, AL O8EB: JNZ 
O8EB) <- the buggy instruction (DOS 3.3). Values of AL other than described here put PCDOS 4.00 into the same 
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loop (the buggy instructions are the same); DOS 5.0 fixes the bug so that SHARE chains to the previous handler if 
AL is nonzero on entry. 

If DOS 4.01 SHARE was automatically loaded, file sharing is in an inactive state until this call is made. 
Conflicts: None known. 
See Also: INT 21h Function 52h 


INTERRUPT 2Fh - Function 10h, Subfunction 40h 


internal - Unknown Function 


Purpose: unknown. 
Available on: DOS 4.x only. 
Registers at call: 

AX = 1040h 

other unknown, 


INTERRUPT 2Fh - Function 10h, Subfunction 80h 
internal - TURN ON FILE SHARING CHECKS 

Purpose: Enable enforcement of file sharing rules. 
Available on: DOS 4.x only. 


Registers at call: 
AX = 1080h 


Restrictions: SHARE.EXE must be installed. 
Return Registers: unknown. 


Restrictions: SHARE.EXE must be installed. 
Return Registers: 
AL = status 

FOh successful 

FFh checking was already on 
Details: DOS 4.x SHARE has two functions: FCB support for large (over 32 MB) media and file sharing checks. If 
SHARE is automatically loaded for FCB support, the file sharing checks are initially turned off; they may also be 
turned off with the undocumented /NC commandline switch. 


See Also: Function 10h Subfunctions 00h and 81h 


INTERRUPT 2Fh - Function 10h, Subfunction 81h 
internal - TURN OFF FILE SHARING CHECKS 


Purpose: Disable enforcement of file sharing rules. 
Available on: DOS 4.x only. 

Registers at call: 

AX = 1081h 


See Also: Function 10h Subfunctions 00h and 80h 
SHELLB.COM (DOS V4 only) 


INTERRUPT 2Fh - Function 19h, Subfunction 00h 
SHELLB.COM - INSTALLATION CHECK 

Purpose: Determine whether SHELLB.COM is installed. 
Available on: DOS 4.x only. 


Registers at call: 
AX = 1900h 


INTERRUPT 2Fh - Function 19h, Subfunction 01h 
SHELLB.COM - SHELLC.EXE INTERFACE 

Purpose: Interfaces to SHELLC. 

Available on: DOS 4.x only. 


Restrictions: SHARE.EXE must be installed. 
Return Registers: 
AL = status 

FOh successful 

FFh checking was already off 


Restrictions: none. 
Return Registers: 
AL = status 
00h not installed 
FFh installed 


Restrictions: SHELLB.COM must be installed. 
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Registers at call: Return Registers: 
AX = 1901h ES:DI -> SHELLC.EXE workspace within 
BL = 00h if SHELLC transient SHELLB.COM 
= Oh if SHELLC resident 
DS:DX -> far call entry point for resident 
SHELLC.EXE 


Details: SHELLB.COM and SHELLC.EXE are parts of the DOS 4.x shell 


INTERRUPT 2Fh - Function 19h, Subfunction 02h 
SHELLB,COM - COMMAND.COM INTERFACE 


Purpose: Interfaces to COMMAND.COM. 


Available on: DOS 4.x only. Restrictions: SHELLB.COM must be installed. 

Registers at call: Return Registers: 

AX = 1902h AL =00h failed, either 

ES:DI -> ASCIZ full filename of current batch file, (a) final filename element quoted at ES:DI does 
with at least the final filename element not match identity of shell batch file quoted as 
uppercased parameter of most recent call of SHELLB 

DS:DX -> buffer for results command, or 


(b) no more Program Start Commands available. 
AL= FFh success, then memory at DS;[DX+1]} 
onwards filled as: 
DX+1: BYTE count of bytes of PSC 
DX+2: NBYTEs Program Start Command text 
BYTE ODh terminator 
Details: COMMAND.COM executes the result of this call in preference to reading a command from a batch file. 
Thus the batch file does not advance in execution for so long as SHELLB provides Program Start Commands from 
its workspace, The PSCs are planted in the SHELLB workspace by SHELLC, the user menu interface. The final PSC 
of a sequence is finished with a GOTO COMMON, which causes a loop back in the batch file which called SHELLC 
so as to execute SHELLC again. The check on batch file name permits PSCs to CALL nested batch files while PSCs 
are still stacked up for subsequent execution. 


INTERRUPT 2Fh - Function 19h, Subfunction 03h 
SHELLB.COM - COMMAND.COM interface 


Purpose: Interface to COMMAND.COM. 


Available on: DOS 4.x only. Restrictions: SHELLB.COM must be installed. 
Registers at call: Return Registers: 
AX = 1903h AL = FFh if quoted batch file name matches last 
ES:DI -> ASCIZ batch file name as for Function SHELLB parameter 

19h Subfunction 02h 


AL = 00h if it does not 


INTERRUPT 2Fh - Function 19h, Subfunction 04h 
SHELLB.COM - SHELLB transient to TSR interface 


Purpose: Allows the transient portion of SHELLB to communicate with the resident portion. 


Available on: DOS 4.x only. Restrictions: SHELLB.COM must be installed. 
Registers at call: Return Registers: 
AX = 1904h ES:DI -> name of current shell batch file: 


WORD number of bytes of name following 
NBYTEs (8 bytes max) uppercase name of shell batch file 


TASK SWITCHER 
With the release of DOS 5.0, Microsoft documented the DOSSHELL task switcher interface. This interface has been 


designed with sufficient generality to allow other task switchers to use the same interface, or even let multiple task 
switchers coexist in memory at once. 
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INTERRUPT 2Fh - Function 4Bh, Subfunction 01h 
BUILD TASK SWITCHER CALLOUT CHAIN 


Purpose: Called by task switcher to permit clients to request notification on task switcher state changes. 


Available on: All machines. Restrictions: none. 

Registers at call: Return Registers: 

AX = 4BO0ih ES:BX -> callback info structure (Table 8-103) 
CX:DX -> task switcher entry point or 0000h:0000h 


(see Function 4Bh Subfunction 02h) 
ES:BX = 0000h:0000h 
Details: This function should be hooked by clients which require notification of task switcher activities; the call must 
first be passed on to the prior handler with registers unchanged using a simulated interrupt. On return, the client 
must build a callback info structure and store the returned ES:BX in the "next" field, then return the address of its 
own callback info structure. 

A client program must add itself to the notification chain if it provides services to other programs; before 
terminating, it must remove itself from the chain by calling the task switcher's entry point with AX=0005h (see 
Function 4Bh Subfunction 02h). 

The task switcher entry point should not be saved, as it is subject to change and will be provided on any 
notification call. 

Conflicts: LAN Manager 2.0 (chapter 27). 
See Also: Function 4Bh Subfunction 02h 


Offset Size Description 
00h DWORD pointer to next callback info structure 
04h DWORD pointer to notification function (see below) 
08h DWORD _ reserved 
0Ch DWORD _ address of zero-terminated list of API info structures 
(see Function 4Bh Subfunction 02h) 
Notification function called with: Function should return: 
AX = function 
0000h switcher initialization AX = 0000h if OK to load 
= nonzero to abort task switcher 
0001h query suspend AX = 0000h if OK to switch session 
BX = session ID = 0001h if not 
0002h suspend session AX = 0000h if OK to switch session 
BX = session ID = 0001h if not 


interrupts disabled 


0003h activate session AX = 0000h 
BX = session ID 
CX = session status flags 
bit 0: set if first activation of session 
bits 1-15: reserved (0) 
interrupts disabled 


0004h session active AX = 0000h 
BX = session ID 
CX = session status flags 
bit 0: set if first activation of session 
bits 1-15: reserved (0) 
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| 0005h create session AX = 0000h if OK to create session 


only switcher loaded 
bits 1-15: reserved (0) 
Details: Function 0000h is generally called by the program which controls or invokes the task switcher, rather than 
by the task switcher itself; the entry point supplied to this function is not necessarily the entry point to the task 
switcher itself, and may be 0000h:0000h. If any client indicates that loading is not possible, all clients will be called 
with function 0007h; thus it is possible for a client to receive a termination notice without a corresponding 
initialization notice. 

Except for functions 0002h and 0003h, the notification handler is called with interrupts enabled and may make 
any INT 21h function call; interrupts must not be enabled in functions 0002h and 0003h, nor may any MSDOS 
i function calls be made. 

i Function 0007h may be called with ES:DI = 0000h:0000h if the entry point is no longer valid. 


INTERRUPT 2Fh - Function 4Bh, Subfunction 02h 


| BX = session ID = 0001h if not 
| 0006h destroy session AX = 0000h 

| BX = session ID 

| 

| 0007h switcher termination AX = 0000h 

| BX = flags ES:DI -> task switcher entry point i 
bit 0: set if calling switcher is the (see Function 4Bh Subfunction 02h) 1 





INSTALLATION CHECK 

Purpose: Determine whether a task switcher is installed. 

Available on: All machines. Restrictions: none. 

Registers at call: Return Registers: 

AX = 4B02h ES:DI = 0000h:0000h if task switcher not loaded 
BX = 0000h ES:DI -> task switcher entry point (see below) 


Details; The returned entry point is that for the most-recently loaded task switcher; the entry points for prior task 
switchers may be determined with the "get version" call (see below). 


Conflicts: LAN Manager 2.0 (chapter 27). 


| 
| 
| 
AX = 0000h 
i 
See Also: Function 44h Subfunction 05h, Function 4Bh Subfunction 03h 
i 


Call task switcher entry point with: Task Switcher Returns: 
AX = 0000h get version CF clear if successful 
AX = 0000h 


ES:BX -> task switcher version structure 
| (Table 8-104) 
| CF set if unsupported function i 


| 
ES:DI = 0000h:0000h if loaded 
| 


i AX =0001h test memory region CF clear if successful 

! ES:DI -> first byte to be tested AX = memory type of tested region 

| CX = size of region to test 0000h global | 
0001h global and local | 


| 0002h local (replaced on session switch) 
| CF set if unsupported function 
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AX = 0002h suspend switcher CF clear if successful 
ES:DI -> new task switcher's entry point AX = state 


0000h switcher has been suspended 
0001h switcher not suspended, new switcher 
must abort 
0002h switcher not suspended, but new 
switcher may run anyway 
CF set if unsupported function 


AX = 0003h resume switcher CF clear if successful 
ES:D] -> new task switcher's entry point AX = 00001 
CF set if unsupported function 

AX = 0004h hook notification chain CF clear if successful 
ES:DI -> callback info structure to be added to AX = 0000! 

chain (see Function 4Bh Subfunction 01h) CF set if unsupported function 
AX = 0005h unhook notification chain CF clear if successful 
ES:DI -> callback info structure to be removed from AX = 0000h 

chain (see Function 4Bh Subfunction 01h) CF set if unsupported function 
AX = 0006h query API support CF clear if successful 
BX = asynchronous API identifier AX = 0000h 





ES:BX -> API info structure (Table 8-105) for the 
client which provides the highest level of 
support 

CF set if unsupported function 


Table 8-104. Format of task switcher version structure: 


Offset 
00h 
02h 
04h 
06h 
08h 
OAh 


0Ch 
10h 


Table 8-105. 


Offset 
00h 
02h 


04h 
06h 


Size 

WORD 
WORD 
WORD 
WORD 
WORD 
WORD 


DWORD 
DWORD 


Description 

major version of supported protocol (current protocol is 1.0) 
minor version of supported protocol 

major version of task switcher 

minor version of task switcher 

task switcher ID (see Function 4Bh Subfunction 03h) 
operation flags 

bit 0: set if task switcher disabled 

bits 1-15; reserved (0) 

pointer to ASCIZ task switcher name 

("MS-DOS Shell Task Switcher" for DOSSHELL task switcher) 
pointer to previous task switcher's entry point or 0000h:0000h 


Format of API info structure: 


Size 
WORD 
WORD 


WORD 
WORD 


Description 

size of structure in bytes (000A) 

API identifier 

0001h NetBIOS 

0002h 802.2 

0003h TCP/IP 

0004h LAN Manager named pipes 

0005h Novell NetWare IPX 

major version of highest version of API for which the support 
minor version / level specified in the next field is provided 


| 
| 
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Table 8-105. Format of API info structure (continued) 


Offset Size Description 

08h WORD support level 
0001h minimal support 
0002h API-level support 
0003h switcher compatibility 
0004h seamless compatibility 


INTERRUPT 2Fh - Function 4Bh, Subfunction 03h 
ALLOCATE TASK SWITCHER ID 


Purpose: Request a new task switcher identifier to ensure unique session identifiers. 
Available on: All machines. Restrictions: Task switcher must be loaded. 


Registers at call: Return Registers: 

AX = 4B03h AX = 0000h 

ES:DI -> task switcher entry point BX = switcher ID (0001h-O00Fh), or 0000h if no more 
(see Function 4Bh Subfunction 02h) available 


Details: If a task switcher has determined that it is the first to be loaded, it must allocate an identifier for itself and 
provide this function to all subsequent task switchers; if it is not the first to be loaded, it must call this function to 
allocate an ID, The switcher ID is used as the high four bits of all session identifiers to ensure unique session IDs. 

If no more switcher IDs are available, the new task switcher making the call must terminate or disable itself. The 
task switcher providing the identifiers may call the new task switcher's entry point as needed, 
Conflicts: LAN Manager 2.0 (chapter 27). 
See Also: Function 4Bh Subfunctions 02h and 04h 


INTERRUPT 2Fh - Function 4Bh, Subfunction 04h 





FREE TASK SWITCHER ID 
Purpose: Deallocate a previously allocated task switcher identifier. 
Available on: All machines. Restrictions: Task switcher must be loaded. 
Registers at call: Return Registers: 
AX = 4B04h AX = 0000h 
BX = switcher ID BX = status 
ES:DI -> task switcher entry point 0000h successful 
(see Function 4Bh Subfunction 02h) other error (invalid ID or ID not allocated) 


Details: This function is called by a task switcher when it exits, unless it was the first loaded and is providing the 
support for Subfunctions 03h and 04h, The task switcher providing the identifiers may call the terminating task 


switcher's entry point as needed. 
This call is available from within DOSSHELL even if the task switcher is not installed, 


Conflicts: LAN Manager 2.0 (chapter 27). 
See Also: Function 4Bh Subfunctions 02h and 03h 


INTERRUPT 2Fh - Function 4Bh, Subfunction 05h 


IDENTIFY INSTANCE DATA 

Purpose: Called by task switchers to allow clients to identify data which must be duplicated for each session. 
Available on: All machines. Restrictions: none. 

Registers at call: Return Registers: 

AX = 4B05h ES:BX -> startup info structure (Table 8-106) or 
ES:BX = 0000h:0000h 0000h:0000h 


CX:DX -> task switcher entry point 

(see Function 4Bh Subfunction 02h) 
Details: Clients with instance data should hook this call, pass it through to the previous handler with unchanged 
registers using a simulated interrupt. On return, the client should create a startup info structure (Table 8-106), store 
the returned ES:BX in the "next" field, and return the address of the created structure in ES:BX. 

All MSDOS function calls are available from within this call. 
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Conflicts; LAN Manager 2.0 (chapter 27). 
See Also: Function 4Bh Subfunction 02h, Windows Function 16h Subfunction 05h (chapter 14) 


Table 8-106. Format of startup info structure: 


Offset Size Description 

00h 2BYTEs major, minor version of info structure (03h,00h) 
02h DWORD pointer to next startup info structure or 0000h:0000h 
06h DWORD — 0000h:0000h (ignored) 

OAh DWORD _ ignored 

OEh DWORD pointer to instance data records (Table 8-107) 


Table 8-107. Format of one instance data record in array: 


Offset Size Description 

00h DWORD _ address of instance data (end of array if 0000h:0000h) 
04h WORD size of instance data 

XMA2EMS.SYS 


INTERRUPT 2Fh - Function 1Bh, Subfunction 00h 
internal - INSTALLATION CHECK 


Purpose: Determine whether XMA2EMS.SYS is installed. 


Available on: DOS 4.0 or higher. Restrictions: none. 
Registers at call: Return Registers: 
AX = 1B00h AL = FFh if installed 


Details: The XMA2EMS.SYS extension is only installed if DOS has page frames to hide. This extension hooks onto 
INT 67h Function 58h and returns from that call data which excludes the physical pages being used by DOS. 
Conflicts: None known. 

See Also: Function 1Bh Subfunction 01h 


INTERRUPT 2Fh - Function 1Bh, Subfunctions 01h-FFh 
internal - GET HIDDEN FRAME INFO 


Purpose: Determine which page frames XMA2EMS has hidden from normal EMS calls. 


Available on: DOS 4.0 or higher, Restrictions; XMA2EMS.SYS must be installed. 
Registers at call: Return Registers: 

AH = 1Bh AX = FFFFh if failed (no such hidden page) 

AL nonzero AX = 0000h if OK, then 

DI = hidden physical page number ES = segment of page frame 


DI = physical page number 
Details: This corresponds to the data edited out of the INT 67h Function 58h call. 
Conflicts: None known. 
See Also: Function 1Bh Subfunction 00h 


Compatible and Semi-Compatible Systems 
The functions described in this section are used by operating systems which are at least somewhat compatible with 
MS-DOS, though not necessarily completely so. In this section, functions are listed in numeric sequence, 


INTERRUPT 21h - Function 44h, Subfunction 51h 


Concurrent DOS - INSTALLATION CHECK 


Purpose: Determine whether Digital Research's Concurrent DOS v3.2 or higher is installed, 
Available on: All machines. Restrictions: none. 





| 
| 
i 
i 
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Registers at call: Return Registers: 
AX = 4451h CF set if not Concurrent DOS 
AX = error code (see DOS Function 59h) 
CF clear if successful 
AH= [4h 
AL = version (high nybble = major version 
low nybble = minor version) 
Conflicts; NewSpace (chapter 6). 
See Also: Function 44h Subfunctions 52h and 59h 


INTERRUPT 21h - Function 44h, Subfunction 52h 
DR DOS 3.41-5.0 - IOCTL - DETERMINE DOS TYPE 


Purpose: Determine DOS type present. 


Available on: All machines. Restrictions: DR DOS rather than MS-DOS must be 
installed, 

Registers at call: Return Registers: 

AX = 4452h CF set if not DR DOS 

CF set AX = error code (see Function 59h) 


CF clear if DR DOS 
Details: The DR DOS version is stored in the environment variable VER. Digital Research indicates that this call 
may change in future versions, making the installation check unreliable. DR DOS 3.41+ is supposedly sufficiently 
compatible with MSDOS that programs need not decide which of the two they are running under. 
Conflicts: None known. 
See Also: Function 44h Subfunctions 51h and 59h 


INTERRUPT 21h - Function 44h, Subfunction 59h 

DR MultiUser DOS 5.0 - API 

Purpose: Alternate, mostly-compatible, operating system. 

Available on: Digital Research DOS 5.0. Restrictions: none. 
Registers at call: Return Registers: n/a 
AX = 4459h 

CL = function (Table 8-108) 

DS,DX = parameters 

Conflicts; None known. 

See Also: Function 44h Subfunction 52h 


Table 8-108. Values for Digital Research DOS 5.0 function number: 


Value Function 

00h terminate calling process 

02h write character to default console (see Function 02h) 
03h read character from default AUX (see Function 03h) 
05h write character to default list device (see Function 05h) 
06h perform raw 1/O on default console 

07h return default AUX input status 

O8h return default AUX output status 

09h write string to default console (see Function 09h) 

OAh read string from default console (see Function 0Ah) 
OBh return default console input status (see Function OBh) 
0Ch get BDOS release ID 

0ODh reset all disk drives (see Function 0Dh) 

QEh set default drive (see Function OEh) 

OFh open file via FCB (see Function OFh) 

10h close file via FCB (see Function 10h) 

lth search for first matching file with FCB (see Function | th) 








| 








\ 
| 
i 
1 
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Table 8-108. Values for Digital Research DOS 5.0 function number (continued) 








CWOADAK 
Soos ss 


RPDS HAHAH 
a 








UBD 
Ssuay 
5 





wa 
BW 
> 


Funetion 

search for next matching file with FCB (see Function 12h) 
delete file via FCB (see Function 13h) 

sequential read via FCB (see Function 14h) 
sequential write via FCB (see Function 15h) 

create file via FCB (see Function 16h) 

rename file via FCB (see Function 17h) 

get bit map of logged drives 

get default drive (see Function 19h) 

set DMA address offset 

get default disk allocation vector (see Function 1Bh) 
set default drive to read-only 

get bit map of read-only drives 

set file attributes via FCB 

get address of disk parameter block (see Function 1Fh) 
get/set default user number 

read random record via FCB (see Function 21h) 
write random record via FCB (see Function 22h) 
compute file size with FCB (see Function 23h) 

get FCB random record number (see Function 24h) 
reset specified drives 

access specified drives 

free specified drives 

write random with FCB, zero fill (see also Function 28h) 
lock records in FCB file (see Function 5Ch) 

unlock records in FCB file (see Function 5Ch) 

set BDOS multisector count 

set BDOS error mode 

get free space on disk 

load, initialize, and jump to process 

flush write-deferred buffers 





* call BIOS character routine 


set DMA address segment 

get DMA buffer address 

CP/M-86 allocate maximum memory 
allocate maximum memory segment absoute 
CP/M-86 allocate memory segment 
allocate memory segment absolute 
CP/M-86 free specified memory segment 
CP/M-86 free all memory 

load .CMD file into memory 

(DR-NET) log on a server 

(DR-NET) log off a server 

(DR-NET) send a message 

(DR-NET) receive a message 

(DR-NET) get network status 

(DR-NET) get requestor configuration table 
(DR-NET) set compatibility attributes 
(DR-NET) get server configuration table 
(DR-NET) set network error mode 
(DR-NET) attach network 

(DR-NET) detach network 

(DR-NET) set default password 
(DR-NET) get-set long timeout 
(DR-NET) get parameter table 
(DR-NET) get network information 

get current time 

set current time 





i 
q 
} 
| 
| 
| 
{ 
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Table 8-108. Values for Digital Research DOS 5.0 function number (continued) 


Value 
55h 
56h 
57h 
58 
59h 
SAh 
SBh 
5Ch 
5Dh 





Function 

get binary system date 

set system date 

allocate system flag 

deallocate system flag 

reserve memory in global area 

lock physical drive 

unlock physical drive 

search path for executable file 

load and execute command (see Function 4Bh) 
get/set process exit code 

set country information 

get country information 

truncate FCB file (see Function 28h) 
create/update directory label 

get directory label 

get FCB date stamp and password mode 
write extended FCB 

set system date and time 

get system date and time in binary 
establish password for file access 

get OS serial number 

get/set console mode 

get/set string delimiter 

write block to default console 

write block to default list device 
execute DOS-compatible function 
set FCB time and date stamps 
allocate memory 

deallocate memory 

poll I/O device 

wait on system flag 

set system flag 

create message queue 

open message queue 

delete message queue 

read from message queue 
conditionally read from message queue 
write to message queue 

conditionally write to message queue 
delay calling process 

call process dispatcher 

terminate calling process 

create a process 

set calling process' priority 

attach to default console 

detach from default console 

assign default console to process 
interpret and execute commandline 
resident procedure library 

parse ASCII string into FCB (see Function 29h) 
return default console 

get address of system data 

get system time and date 

return calling process’ descriptor 
terminate process by name or PD address 
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Table 8-108. Values for Digital Research DOS 5.0 function number (continued) 








Value Function 

9EI attach to default list device 

9Fh detach from default list device 

AOh select default list device 

Alh conditionally attach to default list device 
A2h conditionally attach to default console 
A3h get OS version number 

A4h get default list device 

ASh attach to default AUX 

A6h detach from default AUX 

Aqvh conditionally attach to default AUX 
A8h set default AUX 

Ad return default AUX 

ACh read block from default AUX 

BOh configure default AUX 

Blih get/set device control parameters 
B2h send Break through default AUX 
B3h allocate physical memory 

B4h free physical memory 

BS map physical memory 

Bél nondestructive message queue read 
B7 timed wait on system flag 

B8I get/set I/O port mapping 

B9 set list device timeout 

BAh set AUX timeout value 

BBh execute XIOS service 

FFh return 80386 to native mode 


INTERRUPT 21h - Function 5Fh, Subfunction 05h 


STARLITE architecture - MAP LOCAL DRIVE LETTER TO REMOTE FILE SYSTEM 


Purpose: Map local drive letter to remote file system. 
Available on: STARLITE architecture only. 
Registers at call: 
AX = 5F05h 
DL = drive number (0=A:) 
DS:SI -> ASCIZ name of the object to map the 
drive to 
Conflicts: DOS 4.x + Microsoft Networks. 
See Also: STARLITE Function SFh Subfunction 06h 


INTERRUPT 21h - Function 5Fh, Subfunction 06h 
STARLITE architecture - UNMAP DRIVE LETTER 


Purpose: Removes drive letter mapping. 
Available on: STARLITE architecture only. 
Registers at call: 

AX = SFO6h 

DL = drive to be unmapped (0=A:) 


Conflicts: DOS 4.x + Microsoft Networks. 
See Also: STARLITE Function 5Fh Subfunction 05h 


INTERRUPT 21h - Function 5Fh, Subfunction 07h 


Restrictions: none. 
Return Registers: 
CF set on error 
AX = error code (see Function 59h) 
CF clear if successful 


Restrictions: none. 
Return Registers: 
CF set on error 
AX = error code (see Function 59h) 
CF clear if successful 


STARLITE architecture - MAKE NAMED OBJECT AVAILABLE ON NETWORK 


Purpose: Makes specified object available to network. 


Available on: STARLITE architecture only. 

Registers at call: 

AX = SFO7h 

DS:SI -> ASCIZ name of object to offer to network 

ES:DI -> ASCIZ name under which object will be 
known on the network MUST begin with three 
slashes 

Conflicts: DOS 5.0. 

See Also: Function 5Fh Subfunction 08h 


INTERRUPT 21h - Function 5Fh, Subfunction 08h 
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Restrictions: none. 
Return Registers: 
CF set on error 
AX = error code (see Function 59h) 
CF clear if successful 


STARLITE architecture - REMOVE GLOBAL NETWORK NAME OF OBJECT 
Purpose: Cancels specified network name, making the object inaccessible from the network. 


Available on: STARLITE architecture only. 

Registers at call: 

AX = 5F08h 

DS:SI -> ASCIZ network name (not local name) of 
object to unshare 

Conflicts: DOS 5.0. 

See Also: Function 5Fh Subfunction 07h 


INTERRUPT 21h - Function 5Fh, Subfunction 09h 


STARLITE architecture - BIND TO NETWORK DEVICE 


Purpose: Attach to specified network. 

Available on: STARLITE architecture only. 

Registers at call: 

AX = 5F09h 

DS:DX -> ASCIZ name of the device driver to 
which to attach 


Restrictions: none. 
Return Registers: 
CF set on error 
AX = error code (see Function 59h) 
CF clear if successful 


Restrictions: none. 
Return Registers: 
CF set on error 
AX = error code (see Function 59h) 
CF clear if successful 


Details: The STARLITE distributed file system can attach to multiple networks simultaneously. 


Conflicts: None known. 
See Also: Function 5Fh Subfunction 0Ah 


INTERRUPT 21h - Function 5Fh, Subfunction 0Ah 
OM NETWORK DEVICE 


STARLITE architecture - DETACH FR 


Purpose: Detach from specified network. 

Available on: STARLITE architecture only. 

Registers at call: 

AX = 5FOAh 

DS:DX -> ASCIZ name of device driver to detach 
from 

Conflicts: None known. 

See Also: Function 5Fh Subfunction 09h 


INTERRUPT 2Ch 
STARLITE architecture - KERNEL API 


Restrictions: none. 
Return Registers: 
CF set on error 
AX = error code (see Function 59h) 
CF clear if successful 


Purpose: STARLITE is an architecture by General Software for a series of MS-DOS compatible operating systems 
(OEM DOS, NETWORK DOS, and SMP DOS) to be released in 1991. 


Available on: STARLITE architecture only. 
Registers at call: unknown. 


Restrictions: none. 
Return Registers: unknown. 


Details: The interrupt number is subject to change before the actual release. 


Conflicts: DOS reserved, MS Windows (chapter 14). 


8-146 MS-DOS and Compatibles 


OS/2 compatibility box 
INTERRUPT 2Fh - Function 40h, Subfunction 01h 


OS/2 compatibility box - SWITCHING DOS TO BACKGROUND 


Purpose: Called by OS/2 when the DOS box is about to be placed in the background; the intent is to allow graphics 
programs to save their state until the DOS box is placed in the foreground again. 


Available on: OS/2 systems. Restrictions: none. 
Registers at call: Return Registers: n/a 
AX = 4001h 


Conflicts: None known. 
See Also: Function 40h Subfunction 02h 


INTERRUPT 2Fh - Function 40h, Subfunction 02h 
05/2 compatibility box - SWITCHING DOS TO FOREGROUND 


Purpose: Called by OS/2 when the DOS box is about to be switched to foreground operation. 


Available on: OS/2 systems. Restrictions: none. 
Registers at call: Return Registers: n/a 
AX = 4002h 


Conflicts: None known. 
See Also: Function 40h Subfunction 01h 


Unknown 


INTERRUPT 2Fh - Function ADh, Subfunction 40h 
Unknown Function 


Purpose: unknown. 

Available on: DOS 4.0. Restrictions: unknown, 

Registers at call: Return Registers: unknown. 

AX = AD40h 

DX = unknown. 

other zatknown. 

Details: The only information known about this call is that it is invoked by the PCDOS 4.01 PRINT.COM. 
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DOS Extenders 


As programs on the IBM PC and compatibles became ever larger, the "640K barrier" of real-mode operation became 
an increasing problem. In response, DOS extenders were created to provide nearly-transparent access to DOS (run- 
ning in real mode) from protected mode, With a DOS extender, programs can be recompiled (with minimal changes) 
to permit access to a full 16 megabytes on 80286s and up to 4 gigabytes of memory on the 80386 and later proces- 
sors. The DOS extender handles all the details of switching to real mode on DOS calls and copying data which is be- 
yond the |-megabyte mark so that DOS can access it, while the program continues operating essentially unchanged. 

This chapter is organized by interrupt and function number. This results in the following sequence of sections: 
Rational Systems DOS/16M, Phar Lap 386/DOS-Extender, OS/286 and OS/386, GO32.EXE, Ergo DOS extenders 
installation check, Phar Lap DOS extenders installation check, Generic installation check, Borland DOS extender 
(TKERNEL), Oracle SQL Protected Mode Executive, and University of Salford DBOS. 


Rational Systems DOS/16M 


DOS/I6M is one of the oldest DOS extenders available, and is used in numerous commercial programs, such as Lotus 
1-2-3 version 3.0. 


INTERRUPT 15h - Function BFh 
DOS/16M - INSTALLATION CHECK 


Purpose: Determine whether DOS/16M software is installed. 


Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 

AX = BFO2h DX = nonzero if installed 
DX = 0000h DS:SI - XBRK structure 


Conflicts: None known. 
See Also: INT 2Fh Function Alh, INT 2Fh Function FBA1h 


Phar Lap 386/DOS-Extender 
Phar Lap uses INT 21h Function 25h as the entry point for all 386/DOS-Extender system calls; the DOS real-mode 


Set Interrupt Vector (see chapter 8) which it conflicts with is meaningless in protected mode, These calls are only 
available when directly using 386/DOS-Extender, or when using a product that was created with 386-DOS/Extender. 


INTERRUPT 21h - Function 25h, Subfunction 01h 
RESET 386/D0S-EXTENDER DATA STRUCTURES 


Purpose: Return the DOS extender to a known initial state. 


Available on: 80386 or higher in protected mode. Restrictions: Phar Lap 386/DOS-extender must be 
installed. 

Registers at call: Return Registers: 

AX = 2501h CF clear 


Conflicts: DOS Set Interrupt Vector (chapter 8). 
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INTERRUPT 21h - Function 25h, Subfunction 02h 
GET PROTECTED-MODE INTERRUPT VECTOR 


Purpose: Determine which procedure gains control when a specified interrupt occurs in protected mode. 


Available on: 80386 or higher in protected mode, Restrictions; Phar Lap 386/DOS-extender must be 
installed. 
Registers at call: Return Registers: 
AX = 2502h ES:EBX -> 48-bit address of protected-mode 
CL = interrupt number interrupt handler 
CF clear 


Conflicts: DOS Set Interrupt Vector (chapter 8). 
See Also: Function 25h Subfunctions 03h and 04h, DPMI INT 31h Function 02h Subfunction 04h (Chapter 11) 


INTERRUPT 21h - Function 25h, Subfunction 03h 
GET REAL-MODE INTERRUPT VECTOR 


Purpose: Determine which procedure gains control when a specified interrupt occurs in real mode. 


Available on: 80386 or higher in protected mode. Restrictions: Phar Lap 386/DOS-extender must be 
installed. 

Registers at call: Return Registers: 

AX = 2503h EBX = 32-bit address of real-mode interrupt handler 

CL = interrupt number CF clear 


Conflicts: DOS Set Interrupt Vector (chapter 8). 
See Also: Function 25h Subfunctions 02h and 04h, DPMI INT 31h Function 02h Subfunction 00h (Chapter 11) 


INTERRUPT 21h - Function 25h, Subfunction 04h 
SET PROTECTED-MODE INTERRUPT VECTOR 


Purpose: Specify which procedure gains control when a specified interrupt occurs in protected mode. 


Available on: 80386 or higher in protected mode, Restrictions: Phar Lap 386/DOS-extender must be 
installed. 

Registers at call: Return Registers: 

AX = 2504h CF clear 


CL = interrupt number 
DS:EDX -> 48-bit address of protected-mode 
interrupt handler 
Conflicts: DOS Set Interrupt Vector (chapter 8). 
See Also: Function 25h Subfunctions 02h and 0Sh, DPMI INT 31h Function 02h Subfunction 05h (Chapter 11) 


INTERRUPT 21h - Function 25h, Subfunction 05h 
SET REAL-MODE INTERRUPT VECTOR 


Purpose: Specify which procedure gains control when a specified interrupt occurs in real mode. 


Available on: 80386 or higher in protected mode. Restrictions: Phar Lap 386/DOS-extender must be 
installed. 

Registers at call: Return Registers: 

AX = 2505h CF clear 


CL = interrupt number 
EBX = 32-bit address of real- mode interrupt 
handler 
Conflicts: DOS Set Interrupt Vector (chapter 8). 
See Also: Function 25h Subfunctions 03h and 04h, DPMI INT 31h Function 02h Subfunction 01h (Chapter 11) 


INTERRUPT 2th - Function 25h, Subfunction 06h 
SET INTERRUPT TO ALWAYS GAIN CONTRL IN PROTECTED MODE 


Purpose: Specify that a particular real-mode interrupt will switch to protected mode to invoke the interrupt handler. 
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Available on: 80386 or higher in protected mode. Restrictions: Phar Lap 386/DOS-extender must be 
installed. 

Registers at call: Return Registers: 

AX = 2506h CF clear 


CL = interrupt number 
DS:EDX -> 48-bit address of protected-mode 
interrupt handler 
Details: This function modifies both the real-mode low-memory interrupt vector table and the protected-mode 
Interrupt Descriptor Table (IDT). Interrupts occurring in real mode are resignaled in protected mode. 
Conflicts: DOS Set Interrupt Vector (chapter 8). 


INTERRUPT 21h - Function 25h, Subfunction 07h 
SET REAL- & PROTECTED-MODE INT VECTORS 


Purpose: Specify the procedures which gain control when an interrupt occurs depending on which mode the 
processor is in at the time of the interrupt. 


Available on: 80386 or higher in protected mode, Restrictions: Phar Lap 386/DOS-extender must be 
installed. 

Registers at call: Return Registers: 

AX = 2507h CF clear 


CL = interrupt number 
DS:EDX -> 48-bit address of protected-mode 
interrupt handler 
EBX = 32-bit address of real-mode interrupt handler 
Details: Interrupts are disabled until both vectors have been modified. 
Conflicts: DOS Set Interrupt Vector (chapter 8). 
See Also; Function 25h Subfunctions 04h and 05h 


INTERRUPT 21h - Function 25h, Subfunction 08h 
GET SEGMENT LINEAR BASE ADDRESS 


Purpose: Determine the physical address at which a segment is located. 


Available on; 80386 or higher in protected mode. Restrictions: Phar Lap 386/DOS-extender must be 
installed. 

Registers at call: Return Registers: 

AX = 2508h CF clear if successful 

BX = segment selector ECX = linear base address of segment 


CF set if invalid segment selector 
Conflicts: DOS Set Interrupt Vector (chapter 8). 


INTERRUPT 21h - Function 25h, Subfunction 09h 
CONVERT LINEAR TO PHYSICAL ADDRESS 


Purpose: Determine the physical memory address corresponding to the specified logical address. 


Available on: 80386 or higher in protected mode. Restrictions: Phar Lap 386/DOS-extender must be 
installed. 

Registers at call: Return Registers: 

AX = 2509h CF clear if successful 

EBX = linear address to convert ECX = physical address (carry flag clear) 


CF set if linear address not mapped in page tables 
Conflicts: DOS Set Interrupt Vector (chapter 8). 


INTERRUPT 2th - Function 25h, Subfunction 0Ah 
MAP PHYSICAL MEMORY AT END OF SEGMENT 


Purpose: Associate physical memory with a range of addesses within a segment. 
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Available on: 80386 or higher in protected mode. Restrictions: Phar Lap 386/DOS-extender must be 
installed. 
Registers at call: Return Registers: 
AX = 250Ah CF clear if successful: 
ES = segment selector in the Local Descriptor Table EAX = 32-bit offset in segment of mapped 
(LDT) of segment to modify memory 
EBX = physical base address of memory to map CF set on error 
(multiple of 4K) EAX = error code: 
ECX = number of physical 4K pages to map 08h insufficient memory to create page tables 


09h invalid segment selector 
Conflicts: DOS Set Interrupt Vector (chapter 8). 
See Also: DPMI INT 3th Function 08h Subfunction 00h (Chapter 11) 


INTERRUPT 21h - Function 25h, Subfunction 0Ch 
GET HARDWARE INTERRUPT VECTORS 


Purpose: Determine the mapping from interrupt request lines to interrupt numbers. 


Available on: 80386 or higher in protected mode. Restrictions: Phar Lap 386/DOS-extender must be 
installed. 

Registers at call: Return Registers: 

AX = 250Ch CF clear 


AL = base interrupt vector for IRQO0-IRQ7 

AH = base interrupt vector for IRQ8-IRQI5 

BL = interrupt vector for BIOS print screen function 
Conflicts: DOS Set Interrupt Vector (chapter 8). 
See Also: DPMI INT 31h Function 04h Subfunction 00h (Chapter 11) 


INTERRUPT 21h - Function 25h, Subfunction 0Dh 


GET REAL-MODE LINK INFORMATION 


Purpose: Determine the addresses of procedures and data structures used in switching from real mode to protected 
mode. 


Available on: 80386 or higher in protected mode. Restrictions: Phar Lap 386/DOS-extender must be 
installed. 

Registers at call: Return Registers: 

AX = 250Dh CF clear 


EAX = 32-bit address of real-mode 386/DOS-Extender 
proc that will call through from real mode to a 
protected- mode routine 

EBX = 32-bit real-mode address of intermode call data 
buffer 

ECX = size in bytes of intermode call data buffer 

ES:EDX -> protected-mode address of intermode call 
data buffer 

Conflicts: DOS Set Interrupt Vector (chapter 8). 


INTERRUPT 21h - Function 25h, Subfunction 0Eh 
CALL REAL-MODE PROCEDURE 


Purpose: Invoke a procedure which is running in real mode. 


Available on: 80386 or higher in protected mode. Restrictions: Phar Lap 386/DOS-extender must be 
installed. 


i 
{ 
i 
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Registers at call: Return Registers: 
AX = 250Eh CF clear if successful 
EBX = 32-bit address of real-mode procedure to all segment registers unchanged 
call all general registers contain values set by real- 
ECX = number of two-byte words to copy from mode procedure 


all other flags set as they were left by real- 
mode procedure 
CF set on error 
EAX = error code 
Olh not enough real-mode stack space 


protected-mode stack to real-mode stack 


Conflicts: DOS Set Interrupt Vector (chapter 8). 
See Also: OS/286 Function Elh, DPMI INT 31h Function 03h Subfunction 01h (Chapter 11) 


INTERRUPT 21h - Function 25h, Subfunction OFh 
CONVERT PROTECTED-MODE ADDRESS TO MS-DOS 


Purpose: Determine a real-mode physical address corresponding to the specified logical address. 


Available on: 80386 or higher in protected mode, Restrictions: Phar Lap 386/DOS-extender must be 
installed. 
Registers at call: Return Registers: 
AX = 250Fh CF clear if successful 
ES:EBX -> 48-bit protected-mode address to ECX = 32-bit MS-DOS address 
convert CF set on error 
ECX = length of data, in bytes ECX destroyed 


Conflicts: DOS Set Interrupt Vector (chapter 8). 
See Also: Function 25h Subfunction 10h 


INTERRUPT 21h - Function 25h, Subfunction 10h 
CALL REAL-MODE PROCEDURE, REGISTERS 


Purpose: Invoke a procedure running in real mode with the specified values in the processor registers. 


Available on: 80386 or higher in protected mode. Restrictions: Phar Lap 386/DOS-extender must be 
installed. 
Registers at call: Return Registers: 
AX = 2510h CF clear if successful 
EBX = 32-bit address of real-mode procedure to all segment registers unchanged, EDX unchanged 
call all other general registers contain values set by 
ECX = number of two-byte words to copy to real-mode proc 
protected-mode stack to real-mode stack all other flags are set as they were left by real- 


DS:EDX -> pointer to parameter block (Table 9-1) mode procedure 
real-mode register values are returned in the 
parameter block 
CF set on error 
EAX = error code 
O1h not enough real-mode stack space 
Conflicts: DOS Set Interrupt Vector (chapter 8). 
See Also: Function 25h Subfunction OFh 


Table 9-1. Format of parameter block: 


Offset Size Description 

00h WORD real-mode DS value 
02h WORD real-mode ES value 
04h WORD real-mode FS value 
06h WORD real-mode GS value 


08h DWORD _ real-mode EAX value 
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Table 9-1. Format of parameter block (continued} 


Offset Size Description 

0Ch DWORD _ real-mode EBX value 
10h DWORD _ real-mode ECX value 
14h DWORD _real-mode EDX value 


INTERRUPT 21h - Function 25h, Subfunction 11h 
ISSUE REAL-MODE INTERRUPT 


Purpose: Invoke an interrupt handler which is running in real mode. 


Available on: 80386 or higher in protected mode, Restrictions: Phar Lap 386/DOS-extender must be 
installed. 
Registers at call: Return Registers: 
AX =2511h All segment registers unchanged 
DS:EDX -> pointer to parameter block (Table 9-2) EDX unchanged 
All other registers contain values set by the real- mode 
int handler 


The flags are set as they were left by the real- mode 
interrupt handler 
Real-mode register values are returned in the 
parameter block 
Details: All other real-mode values set from protected-mode registers, 
Conflicts: DOS Set Interrupt Vector (chapter 8). 
See Also: Function 25h Subfunctions 03h and 05h, DPMI Function 03h Subfunction 00h (Chapter 11) 


Table 9-2. Format of parameter block: 


Offset Size Description 

00h WORD interrupt number 

02h WORD real-mode DS value 
04h WORD real-mode ES value 
06h WORD real-mode FS value 
O8h WORD real-mode GS value 
QAh DWORD _real-mode EAX value 
OEh DWORD _ real-mode EDX value 


INTERRUPT 21h - Function 25h, Subfunction 12h 
LOAD PROGRAM FOR DEBUGGING 


Purpose: Read a program into memory but do not start executing it. 


Available on: 80386 or higher in protected mode. Restrictions: Phar Lap 386/DOS-extender must be 
installed. 

Registers at call: Return Registers: 

AX = 2512h CF clear if successful 

DS:EDX -> pointer to ASCIIZ program name EAX = number of segment descriptors in LDT 

ES:EBX -> pointer to parameter block (Table 9-3) CF set on error 

ECX = size in bytes of LDT buffer EAX = error code 


02h file not found or path invalid 
O5h access denied 
08h insufficient memory 
OAh environment invalid 
OBh invalid file format 
80h LDT too small 
Conflicts: DOS Set Interrupt Vector (chapter 8). 
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Table 9-3. Format of parameter block: 


Offset 


Input: 
00h 
04h 
06h 
OAh 
0Ch 
10h 


Output: 
12h 
14h 


16h 
1Ah 
1Ch 
20h 
22h 
24h 
26h 
28h 


Size 


DWORD 
WORD 
DWORD 
WORD 
DWORD 
WORD 


WORD 
WORD 


DWORD 
WORD 
DWORD 
WORD 
WORD 
WORD 
WORD 
WORD 


Description 


32-bit offset of environment string 
segment of environment string 
32-bit offset of command-tail string 
segment of command-tail string 
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32-bit offset of LDT buffer (size in BCX) 


segment of LDT buffer 


real-mode paragraph address of PSP (see also INT 21h Function 26h [chapter 8]) 


real/protected mode flag 
0000h real mode 
0001h protected mode 
initial HIP value 

initial CS value 

initial ESP value 
initial SS value 

initial DS value 

initial ES value 

initial FS value 

initial GS value 


INTERRUPT 21h - Function 25h, Subfunction 13h 
ALIAS SEGMENT DESCRIPTOR 

Purpose: Create a new segment selector which refers to the same memory as the specified selector. 
Available on: 80386 or higher in protected mode. 


Registers at 
AX = 2513h 


call: 


BX = segment selector of descriptor in GDT or 


LDT 


CL = access-rights byte for alias descriptor 

CH = use-type bit (USE16 or USE32) for alias 
descriptor 

Conflicts: DOS Set Interrupt Vector (chapter 8). 


INTERRUPT 21h - Function 25h, Subfunction 14h 


CHANGE SEGMENT ATTRIBUTES 


Purpose: Specify the segment type for the given selector. 
Available on: 80386 or higher in protected mode. 


Registers at 
AX = 2514h 


call: 


BX = segment selector of descriptor in GDT or 


LDT 


CL = new access-rights byte 

CH = new use-type bit (USE16 or USE32) 
Conflicts: DOS Set Interrupt Vector (chapter 8). 
See Also: Function 25h Subfunction 15h, DPMI Function 00h Subfunction 09h (Chapter 11) 


Restrictions: Phar Lap 386/DOS-extender must be 
installed. 
Return Registers: 
CF clear if successful 
AX = segment selector for created alias 
CF set on error 
EAX = error code 
08h insufficient memory (can't grow LDT) 
09h invalid segment selector in BX 


Restrictions: Phar Lap 386/DOS-extender must be 
installed. 
Return Registers: 
CF clear if successful 
CF set on error 
EAX = error code 
09h invalid selector in BX 
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INTERRUPT 21h - Function 25h, Subfunction 15h 


GET SEGMENT ATTRIBUTES 
Purpose: Determine the type of segment for the specified selector. 
Available on: 80386 or higher in protected mode. Restrictions: Phar Lap 386/DOS-extender must be 
installed. 
Registers at call: Return Registers: 
AX = 2515h CF clear if successful 
BX = segment selector of descriptor in GDT or CL = access-rights byte for segment 
LDT CH = use-type bit (USE16 or USE32) 


ECX<16-31> destroyed 
CF set on error 
EAX = error code 
09h invalid segment selector in BX 
Conflicts: DOS Set Interrupt Vector (chapter 8). 
See Also: Function 25h Subfunction 14h 


INTERRUPT 21h - Function 25h, Subfunction 16h 
FREE ALL MEMORY OWNED BY LDT 


Purpose: Release the memory allocated to each descriptor within the specified Local Descriptor Table. 


Available on: 80386 or higher in protected mode. Restrictions: Phar Lap 386/DOS-extender must be 
installed. 

Registers at call: Return Registers: unknown. 

AX = 2516h 


others unknown. 
Conflicts: DOS Set Interrupt Vector (chapter 8). 


INTERRUPT 21h - Function 25h, Subfunction 17h 
GET INFO ON DOS DATA BUFFER 


Purpose: Determine the size and location of the real-mode buffer used in making DOS function calls from protected 
mode. 


Available on: 80386 or higher in protected mode. Restrictions: Phar Lap 386/DOS-extender must be i 

installed. i 
Registers at call: Return Registers: unknown. ! 
AX = 2517h : 


others unknown. 
Conflicts: DOS Set Interrupt Vector (chapter 8). 


INTERRUPT 21h - Function 25h, Subfunction 18h 
SPECIFY HANDLER FOR MOVED SEGMENTS 


Purpose: /ndicate which procedure is to be called when a memory segment is moved. 


Available on: 80386 or higher in protected mode. Restrictions: Phar Lap 386/DOS-extender must be 
installed. 

Registers at call: Return Registers: unknown. 

AX =2518h 


others unknown. 
Conflicts: DOS Set Interrupt Vector (chapter 8). 


INTERRUPT 21h - Function 25h, Subfunction 19h 

VMM - GET ADDITIONAL MEMORY ERROR INFO 

Purpose: Retrieve more detailed information on the previous memory-related error. 

Available on: 80386 or higher in protected mode. Restrictions: Phar Lap 386/DOS-extender Virtual 
Memory Manager must be installed. 
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Registers at call: Return Registers: 


AX = 2519h CF clear 
BAX = error code: 


0000h no error 
0001h out of physical memory 
0002h out of swap space (unable to grow swap 
file) 
0003h out of LDT entries and unable to grow 
LDT 
0004h unable to change extended memory 
allocation mark 
FFFFFFFFh paging disabled 
Details: VMM is the Virtual Memory Manager option. 
Conflicts: DOS Set Interrupt Vector (chapter 8). 


INTERRUPT 21h - Function 25h, Subfunction 1Ah 
VMM - LOCK PAGES IN MEMORY 


Purpose: Prevent a range of pages from being swapped out of memory when demand for memory exceeds the 
available physical memory. 


Available on: 80386 or higher in protected mode. Restrictions: Phar Lap 386/DOS-extender Virtual 
Memory Manager must be installed. 
Registers at call: Return Registers: 
AX =251Ah CF clear if successful 
EDX = number of 4k pages to lock CF set on error 
if BL =00h EAX = error code 
ECX = linear address of first page to lock 08h insufficient memory 
if BL = 01h 09h invalid address range 


ES:ECX -> pointer to first page to lock 
Conflicts: DOS Set Interrupt Vector (chapter 8). 
See Also: Function 25h Subfunction 1Bh, OS/386 Function EBh Subfunction 06h, DPMI INT 31h Function 06h 


Subfunction 00h (Chapter 11) 
INTERRUPT 21h - Function 25h, Subfunction 1Bh 


ViMIM - UNLOCK PAGES 
Purpose: Allow a range of memory pages to be swapped out when demand for memory exceeds the available 
physical memory. 
Available on: 80386 or higher in protected mode. Restrictions: Phar Lap 386/DOS-extender Virtual 
Memory Manager must be installed. 
Registers at call: AX = 251Bh Return Registers: 
EDX = number of pages to unlock CF clear if successful 
if BL = 00h CF set on error 
ECX = linear address of first page to unlock EAX = error code 
if BL =Oth 09h invalid address range 


ES:ECX -> pointer to first page to unlock 
Conflicts: DOS Set Interrupt Vector (chapter 8). 
See Also: Function 25h Subfunction 1Ah, OS/386 Function EBh Subfunction 07h, DPMI INT 31h Function 06h 


Subfunction 01h (Chapter 11) 


INTERRUPT 21h - Function 25h, Subfunction 1Dh 

VMM - READ PAGE-TABLE ENTRY 

Purpose: Determine the attributes and physical location of a 4K memory page. 

Available on: 80386 or higher in protected mode. Restrictions: Phar Lap 386/DOS-extender Virtual 
Memory Manager must be installed, 
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Registers at call: Return Registers: unknown. 
AX =251Dh 


Others unknown. 
Conflicts: DOS Set Interrupt Vector (chapter 8). 


See Also: Function 25h Subfunction 1Eh, OS/386 Function EBh Subfunction 00h, DPMI INT 31h Function 05h 
Subfunction 06h (Chapter 11) 


INTERRUPT 27h - Function 25h, Subfunction 1Eh 
VMM - WRITE PAGE-TABLE ENTRY 


Purpose: Specify the attributes and physical location of a4K memory page. 


Available on: 80386 or higher in protected mode. Restrictions: Phar Lap 386/DOS-extender Virtual 
Memory Manager must be installed. 

Registers at call: Return Registers: unknown. 

AX = 251Eh 


Others unknown, 
Conflicts: DOS Set Interrupt Vector (chapter 8). 
See Also: Function 25h Subfunction 1Dh, DPMI INT 31h Function 05h Subfunction 07h (Chapter 11) 


INTERRUPT 21h - Function 25h, Subfunction 1Fh 
VMM - EXHANGE TWO PAGE-TABLE ENTRIES 


Purpose: Swap the physical location and attributes of two 4K memory pages. 


Available on: 80386 or higher in protected mode. Restrictions: Phar Lap 386/DOS-extender Virtual 
Memory Manager must be installed. 

Registers at call: Return Registers: unknown. 

AX = 251Fh 


Others unknown. 
Conflicts: DOS Set Interrupt Vector (chapter 8). 
See Also: Function 25h Subfunctions 1Dh and 1Eh 


INTERRUPT 21h - Function 25h, Subfunction 20h 
VMM - GET MEMORY STATISTICS 


Purpose: Retrieve detailed information about memory use and availability. 


Available on: 80386 or higher in protected mode, Restrictions: Phar Lap 386/DOS-extender Virtual 
Memory Manager must be installed. 

Registers at call: Return Registers: 

AX = 2520h carry flag clear 


DS:EDX -> pointer to buffer at least 100 bytes in 
size (Table 9-4) 

BL = 0 (don't reset VM stats), 1 (reset VM stats) 

Conflicts: DOS Set Interrupt Vector (chapter 8). 


Table 9-4. Format of VM statistics buffer: 


Offset Size Description 
00h DWORD VM status 

0001h VM subsystem is present 

0000h VM not present 
04h DWORD — "“nconvpg" number of conventional memory pages available 
08h DWORD — "nbimpg" number of Compaq built-in memory pages available 
0Ch DWORD  "nextpg" total number of extended memory pages 
10h DWORD _ "extlim" extender memory pages limit 
14h DWORD — "“aphyspg” number of physical memory pages allocated to appl 
18h DWORD  “alockpg" number of locked pages owned by application 


Ch DWORD _ "sysphyspg” number physical memory pages allocated to system 
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Table 9-4. Format of VM statistics buffer (continued) 


Offset Size Description 

20h DWORD  "nfreepg" number of free physical pages; approx if EMS VCPI 
24h DWORD linear address of beginning of application address space 
28h DWORD linear address of end of application address space 

2Ch DWORD number of seconds since last time VM stats were reset 

30h DWORD _ number of page faults since last time 

34h DWORD number of pages written to swap file since last time 

38h DWORD _ number of reclaimed pages (page faults on swapped pages) 
3Ch DWORD — number of virtual pages allocated to the application 

40h DWORD _ size in pages of swap file 

44) DWORD number of system pages allocated with EMS calls 

48h DWORD minimum number of conventional memory pages 

4Ch DWORD maximum size in bytes to which swap file can be increased 
50h DWORD  "vmflags" bit 0 = | if page fault in progress 

54h 16 BYTEs reserved for future expansion (set to zero) 








INTERRUPT 21h - Function 25h, Subfunction 21h 
VMM - LIMIT PROGRAM'S EXTENDED MEMORY USAGE 


Purpose: Specify the maximum amount of protected-mode memory a program may allocate. 


Available on: 80386 or higher in protected mode. Restrictions: Phar Lap 386/DOS-extender Virtual 
Memory Manager must be installed. 
Registers at call: Return Registers: 
AX = 2521h CF clear if successful 
EBX = max 4k pages of physical extended memory EBX = maximum limit in pages 
which program may use ECX = minimum limit in pages 


CF set on error 
BAX = error code 
08h insufficient memory or - nopage switch 
used 
Conflicts: DOS Set Interrupt Vector (chapter 8). 
See Also: Function 25h Subfunction 22h 


INTERRUPT 21h - Function 25h, Subfunction 22h 
VMI - SPECIFY ALTERNATE PAGE-FAULT HANDLER 


Purpose: Indicate which routine is to be given control when a program accesses a page of memory which is 
currently swapped out. 


Available on: 80386 or higher in protected mode. Restrictions; Phar Lap 386/DOS-extender Virtual 
Memory Manager must be installed, 

Registers at call: Return Registers: unknown. 

AX =2522h 


Others unknown, 
Conflicts: DOS Set Interrupt Vector (chapter 8). 
See Also: Function 25h Subfunction 23h 


INTERRUPT 21h - Function 25h, Subfunction 23h 
VMM - SPECIFY OUT-OF-SWAP-SPACE HANDLER 


Purpose: Indicate which routine ts to be given control when virtual memory use exceeds the available swapping 


space. 

Available on: 80386 or higher in protected mode. Restrictions: Phar Lap 386/DOS-extender Virtual 
Memory Manager must be installed. 

Registers at call: Return Registers: unknown. 

AX = 2523h 


Others unknown. 
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Conflicts: DOS Set Interrupt Vector (chapter 8). 
See Also: Function 25h Subfunction 22h 


INTERRUPT 21h - Function 25h, Subfunction 24h 
VMM - INSTALL PAGE-REPLACEMENT HANDLERS 


Purpose: Specify routines to be called in order to determine which page(s) to swap out when memory demands 
exceed the available physical memory, 


Available on: 80386 or higher in protected mode. Restrictions: Phar Lap 386/DOS-extender Virtual 
Memory Manager must be installed. 

Registers at call: Return Registers: unknown. 

AX = 2524h 


Others unknown. 
Conflicts: DOS Set Interrupt Vector (chapter 8), 


INTERRUPT 21h - Function 25h, Subfunction 25h 
VMM - LIMIT PROGRAM'S CONVENTIONAL MEMORY USAGE 


Purpose: Specify the maximum amount of real-mode memory a program may allocate. 


Available on: 80386 or higher in protected mode. Restrictions: Phar Lap 386/DOS-extender Virtual 
Memory Manager must be installed. 
Registers at call: Return Registers: 
AX = 2525h CF clear if successful 
EBX = limit in 4k pages of physical conventional EBX = maximum limit in pages 
memory which program may use ECX = minimum limit in pages 


CF set on error 
EAX = error code 
08h insufficient memory or - nopage switch 


used 
Conflicts: DOS Set Interrupt Vector (chapter 8). 
See Also: Function 25h Subfunction 21h 
INTERRUPT 21h - Function 25h, Subfunction 26h 
GET CONFIGURATION INFORMA TION 
Purpose: Retrieve detailed information on the system's configuration. 
Available on: 80386 or higher in protected mode. Restrictions: Phar Lap 386/DOS-extender must be 
installed. 
Registers at call: Return Registers: unknown. 
AX = 2526h 
others unknown. 
Conflicts: DOS Set Interrupt Vector (chapter 8). 
INTERRUPT 21h - Function 25h, Subfunction COh 
ALLOCATE MS-DOS MEMORY BLOCK 
Purpose: Request a block of real-mode memory from MSDOS. 
Available on: 80386 or higher in protected mode. Restrictions: Phar Lap 386/DOS-extender must be 
installed. 
Registers at call: Return Registers: 
AX = 25COh CF clear if successful 
BX = number of [6-byte paragraphs of MS-DOS AX = real-mode paragraph address of memory 
memory requested CF set on error 
AX = error code 


07h MS-DOS memory control blocks 
destroyed 


DOS Extenders 9-13 


08h insufficient memory 
BX = size in paragraphs of largest available 
memory block 
Conflicts: DOS Set Interrupt Vector (chapter 8). 
See Also: Function 25h Subfunctions Cth and C2h 


INTERRUPT 21h - Function 25h, Subfunction Cth 
RELEASE MS-DOS MEMORY BLOCK 


Purpose: Return a block of real-mode memory to MSDOS. 


Available on: 80386 or higher in protected mode. Restrictions: Phar Lap 386/DOS-extender must be 
installed, 
Registers at call: Return Registers: 
AX = 25Cih CF clear if successful 
CX = real-mode paragraph address of memory EAX destroyed 
block to free CF set on error 


AX = error code 
07h MS-DOS memory control blocks 
destroyed 
09h invalid memory block address in CX 
Conflicts: DOS Set Interrupt Vector (chapter 8). 
See Also: Function 25h Subfunctions COh and C2h 


INTERRUPT 21h - Function 25h, Subfunction C2h 
MODIFY MS-DOS MEMORY BLOCK 


Purpose: Change the size of a previously allocated real-mode memory block. 


Available on: 80386 or higher in protected mode. Restrictions; Phar Lap 386/DOS-extender must be 
installed. 
Registers at call: Return Registers: 
AX = 25C2h CF clear if successful 
BX = new requested block size in paragraphs EAX destroyed 
CX = real-mode paragraph address of memory CF set on error 
block to modify AX = error code 
07h MS-DOS memory control blocks 
destroyed 


O8h insufficient memory 
09h invalid memory block address in CX 
BX = size in paragraphs of largest available 
memory block 
Conflicts: DOS Set Interrupt Vector (chapter 8), 
See Also: Function 25h Subfunctions COh and Clh 


INTERRUPT 21h - Function 25h, Subfunction C3h 


EXECUTE PROGRAM 

Purpose: Start running the specified program with the given command line and environment. 

Available on: 80386 or higher in protected mode. Restrictions: Phar Lap 386/DOS-extender must be 
installed. 

Registers at call: Return Registers: 

AX =25C3h CF clear if successful 

ES:EBX -> pointer to parameter block (Table 9-5) all registers unchanged 

DS:EDX -> pointer to ASCIIZ program filename CF set on error 


EAX = error code: 
OLh function code in AL is invalid 
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02h file not found or path invalid 
O5h access denied 
08h insufficient memory to load program 
OAh environment invalid 
OBh invalid file format 
Conflicts: DOS Set Interrupt Vector (chapter 8). 


Table 9-5, Format of parameter block: 


Offset Size Description 

00h DWORD 32-bit offset of environment string 

04h WORD segment selector of environment string 
06h DWORD 32-bit offset of command-tail string 
OAh WORD segment selector of command-tail string 


INTERRUPT 21h - Function 30h 
GET DOS-EXTENDER VERSION 


Purpose: Determine which version of the Phar Lap DOS extender is installed. 


Available on: 80386 or higher in protected mode, Restrictions: Phar Lap 386/DOS-extender must be 
installed, 

Registers at call: Return Registers: unknown. 

AH = 30h 


EBX = 50484152h ("PHAR") 
Conflicts: DOS 2+ Get DOS Version (chapter 8), CTask 2.0+ (chapter 17), "Dutch-555" virus (chapter 34). 


08/286 and 0S/386 
OS/286 and OS/386 are 80286- and 80386-specific DOS extenders, respectively. Originally by AI Architects, they 
are now being marketed and further developed by Ergo Computing. 


INTERRUPT 21h - Function E0h 
INITIALIZE REAL PROCEDURE 


Purpose: Prepare for calling a procedure running in real mode. 


Available on: 80286 or higher. Restrictions: OS/286 or OS/386 must be installed. 
Registers at call: Return Registers: unknown. 
AH = E0h 


others unknown. 

Conflicts: DoubleDOS (chapter 17), Alloy NTNX (chapter 18), Novell NetWare 4.0 (chapter 20), "Jerusalem" and 
"Armagedon” viruses (chapter 34), "8-tunes" virus (chapter 34). 

See Also: Functions Elh and E2h 


INTERRUPT 21h - Function Eth 
ISSUE REAL PROCEDURE CALL 


Purpose: Call a procedure which runs in real mode. 


Available on: 80286 or higher. Restrictions: OS/286 or OS/386 must be installed. 
Registers at call: Return Registers: unknown. 
AH =Eth 


others unknown. 

Details: This function is presumably available in protected mode only. 

Conflicts: DoubleDOS (chapter 17), Novell NetWare 4.0 (chapter 20), "Mendoza", "Fu Manchu” viruses (chapter 
34). 

See Also: Functions E0h, E2h, and E3h, Phar Lap Function 25h Subfunction OEh DPMI INT 31h Function 03h 
Subfunction O1h (chapter 11) 
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INTERRUPT 21h - Function E2h 
SET REAL PROCEDURE SIGNAL HANDLER 


Purpose: Specify the real-mode function to receive control when a signal is issued. 


Available on: 80286 or higher. Restrictions: 0S/286 or OS/386 must be installed. 
Registers at call: Return Registers: unknown. 
AH = E£2h 


others unknown. 
Conflicts: DoubleDOS (chapter 17), Alloy NTNX (chapter 18), Novell NetWare 4.0 (chapter 20). 


See Also: Functions E0h, Elh, and E6h 
INTERRUPT 21h - Function E3h 


ISSUE REAL INTERRUPT 

Purpose: Invoke an interrupt handler running in real mode. 

Available on: 80286 or higher. Restrictions: OS/286 or OS/386 must be installed. 
Registers at call: Return Registers: unknown. 

AH = E3h 


AL = interrupt number 

others unknown. 

Details: This function is presumably available in protected mode only. 

Conflicts: None known. 

See Also; Function Elh, Phar Lap Function 25h Subfunction 11h, DPMI INT 31h Function 03h Subfunction 00h 


(chapter 11) 


INTERRUPT 21h - Function E4h, Subfunction 00h 
CHAIN TO REAL-MODE HANDLER 


Purpose: Pass an interrupt down to a chained handler running in real mode. 


Available on: 80286 or higher. Restrictions: OS/286 or OS/386 must be installed. 
Registers at call: Return Registers: unknown. 
AX = E400h 


others unknown. 
Details: This function is presumably available in protected mode only. 
Conflicts: None known. 


INTERRUPT 21h - Function E4h, Subfunction 02h 
SET PROTECTED-MODE TASK GATE 


Purpose: Specify a task gate for calls between processes. 


Available on: 80286 or higher. Restrictions: OS/286 or OS/386 must be installed. 
Registers at call: Return Registers: unknown. 
AX = E402h 


others unknown. 

Details: This function is presumably available in protected mode only. 
Conflicts: None known. 

See Also: Function E4h Subfunction 03h 


INTERRUPT 21h - Function E4h, Subfunction 03h 
REMOVE PROTECTED-MODE TASK GATE 


Purpose: Delete a previously-created task gate. 


Available on: 80286 or higher. Restrictions: OS/286 or OS/386 must be installed. 
Registers at call: Return Registers: unknown. 
AX = E403h 


others unknown. 
Details: This function is presumably available in protected mode only. 
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Conflicts: None known. 
See Also: Function E4h Subfunction 02h 


INTERRUPT 21h - Function E5h, Subfunction 00h 
HEAP MANAGEMENT STRATEGY 


Purpose: Determine the manner in which the heap of allocatable memory is managed. 


Available on: 80286 or higher. Restrictions: OS/286 or OS/386 must be installed. 
Registers at call: Return Registers: unknown. 
AX = E500h 


others unknown. 
Conflicts: None known. 
See Also: Function E5h Subfunction 01h 


INTERRUPT 21h - Function E5h, Subfunction 01h 


FORCE HEAP COMPACTION 

Purpose: Consolidate free areas of memory. 

Available on: 80286 or higher. Restrictions: OS/286 or OS/386 must be installed. 
Registers at call: Return Registers: unknown. 

AX = E501h 


others unknown. 
Conflicts: None known. 
See Also: Function E5h Subfunction 00h 


INTERRUPT 21h - Function E6h 
ISSUE REAL PROCEDURE SIGNAL FROM PROTECTED MODE 


Purpose: Send a signal which will invoke a previously-defined function in real mode. 


Available on: 80286 or higher. Restrictions: OS/286 or OS/386 must be installed. 
Registers at call: Return Registers: unknown. 
AH = E6h 


others unknown. 

Details: This function is presumably available in protected mode only. 
Conflicts: None known. 

See Also: Function E2h 


INTERRUPT 21h - Function E7h 
CREATE CODE SEGMENT 


Purpose: Create a new segment descriptor for a code segment and return its selector. 

Available on: 80286 or higher. Restrictions: OS/286 or OS/386 must be installed. 
Registers at call: Return Registers: unknown. 

AH = E7h 

others unknown, 

Conflicts: None known. 

See Also: Functions E8h, E9h and EAh 


INTERRUPT 21h - Function E8h 


SEGMENT CREATION 

Purpose: Create a new segment descriptor of a specified type and return its selector, 

Available on: 80286 or higher. Restrictions: OS/286 or OS/386 must be installed. 
Registers at call: Return Registers: unknown, 

AH =E8h 

AL = type 


00h data segment 
Oth data window/alias 
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02h real segment 
03h real window/alias 
OGh shareable segment 
others unknown. 
Conflicts: None known. 
See Also: Functions E7h, E9h and EAh 


INTERRUPT 21h - Function E9h 


CHANGE SEGMENTS 

Purpose: Modify the descriptor corresponding to a segment selector. 

Available on: 80286 or higher, Restrictions: OS/286 or OS/386 must be installed. 
Registers at call: Return Registers: unknown. 

AH=E9h 


AL = function: 
Olh change code segment parameters 
02h change data segment parameters 
O5h adjust segment limit 
OGh change segment base address 
others unknown. 
Details: This function is presumably available in protected mode only. 
Conflicts: None known. 
See Also: Functions E7h, E8h, EAh, and EDh, DPMI INT 31h Function 00h Subfunctions 07h-O9h (chapter [1) 


INTERRUPT 2th - Function EAh 


ALLOCATE HUGE SEGMENT 

Purpose: Allocate a block of memory larger than 64K. 

Available on: 80286 or higher. Restrictions: OS/286 or OS/386 must be installed. 
Registers at call: Return Registers: unknown. 

AH =EAh 


others unknown. 

Details: This function is presumably available in protected mode only. 
Conflicts: None known, 

See Also: Functions E7h, E8h and E9h 


INTERRUPT 21h - Function EBh, Subfunction 00h 
VIM - GET A PAGE TABLE ENTRY BY LINEAR ADDRESS 


Purpose: Determine the attributes and physical location of a 4K memory page. 


Available on: 80386 or higher. Restrictions: OS/386 Virtual Memory Manager must 
be installed. 

Registers at call: Return Registers: unknown. 

AX = EB00h 


others unknown, 

Details: This function is presumably available in protected mode only. 

Conflicts: None known. 

See Also: Function EBh Subfunctions 02h and 04h, Phar Lap Function 25h Subfunction [Dh, DPMI INT 31h 
Function 05h Subfunction 06h (Chapter 11) 


INTERRUPT 21h - Function EBh, Subfunction 02h 
VM - GET A PAGE TABLE ENTRY BY 16-BIT SEGMENT:OFFSET 


Purpose: Determine the attributes and physical location of a 4K memory page. 
Available on: 80386 or higher. Restrictions: OS/386 Virtual Memory Manager must 
be installed. 
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Registers at call: Return Registers: unknown. 
AX = EBQ2h 

others unknown, 

Details: This function is presumably available in protected mode only. 

Conflicts: None known. 

See Also: Function EBh Subfunctions 00h and 04h 


INTERRUPT 21h - Function EBh, Subfunction 03h 
VMM - FREE MAPPED PAGES 


Purpose: Remove the association between a range of logical addresses and physical memory. 


Available on: 80386 or higher. Restrictions: OS/386 Virtual Memory Manager must 
be installed. 

Registers at call: Return Registers: unknowz. 

AX = EBO03h 


others unknown. 

Details: This function is presumably available in protected mode only. 

Conflicts: None known. 

See Also: Function EBh Subfunction 05h, DPMI INT 31h Function 08h Subfunction 01h (Chapter 11) 


INTERRUPT 21h - Function EBh, Subfunction 04h 
VIM - GET A PAGE TABLE ENTRY BY 32-BIT SEGMENT:OFFSET 


Purpose: Determine the attributes and physical location of a 4K memory page. 


Available on: 80386 or higher. Restrictions: OS/386 Virtual Memory Manager must 
be installed. 

Registers at call: Return Registers: unknown. 

AX = EBO4h 


others unknown. 

Details: This function is presumably available in protected mode only. 
Conflicts: None known. 

See Also: Function EBh Subfunctions 00h and 02h 


INTERRUPT 21h - Function EBh, Subfunction 05h 


VMM - MAP PAGES 

Purpose: Associate physical memory with a range of logical addresses. 

Available on: 80386 or higher. Restrictions: OS/386 Virtual Memory Manager must 
be installed. 

Registers at call: Return Registers: unknown. 

AX = EBOSh 


others unknown. 

Details: This function is presumably available in protected mode only. 

Conflicts: None known. 

See Also: Function EBh Subfunction 03h, DPMI INT 31h Function 08h Subfunction 00h (Chapter 11) 


INTERRUPT 21h - Function EBh, Subfunction 06h 
VM - LOCK PAGES IN MEMORY 


Purpose: Prevent a range of pages from being swapped out of memory when demand for memory exceeds the 
available physical memory. 


Available on: 80386 or higher, Restrictions: OS/386 Virtual Memory Manager must 
be installed. 

Registers at call: Return Registers: unknown, 

AX = EBO6h 


others unknown. 
Details: This function is presumably available in protected mode only. 
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Conflicts: None known, 
See Also: Function EBh Subfunction 07h, Phar Lap Function 25h Subfunction 1Ah, DPMI INT 31h Function 06h 


Subfunction 00h (Chapter 11) 


INTERRUPT 21h - Function EBh, Subfunction 07h 
VMM - UNLOCK MEMORY PAGES 


Purpose: Allow a range of memory pages to be swapped out when demand for memory exceeds the available 
physical memory. 


Available on: 80386 or higher. Restrictions: OS/386 Virtual Memory Manager must 
be installed. 

Registers at call: Return Registers: unknown. 

AX = EBO7h 


others unknown. 

Details: This function is presumably available in protected mode only. 

Conflicts: None known. 

See Also: Function EBh Subfunction 06h, Phar Lap Function 25h Subfunction 1Bh, DPMI INT 3th Function 06h 


Subfunction 01h (Chapter 11) 
INTERRUPT 21h - Function ECh 


BLOCK TRANSFER 

Purpose: Copy a section of memory. 

Available on; 80286 or higher. Restrictions: OS/286 or OS/386 must be installed. 
Registers at call: Return Registers: unknown. 

AH =ECh 


others unknown. 
Conflicts: None known, 


INTERRUPT 21h - Function EDh 
GET SEGMENT OR WINDOW DESCRIPTOR 


Purpose: Determine the location, size, and attributes of a memory segment. 


Available on: 80286 or higher. Restrictions: OS/286 or OS/386 must be installed. 
Registers at call: Return Registers: unknown. 
AH = EDh 


others unknown. 

Details: This function is presumably available in protected mode only. 
Conflicts: None known. 

See Also: Function E9h 


GO32,EXE 
GO32 is a DOS extender written to support an 80386 port of the Free Software Foundation's GNU C and C++ 


compilers made by DJ Delorie. 


INTERRUPT 21h - Function FFh, Subfunctions 01h to 07h 


DOS EXTENSIONS 

Purpose: Simplify access to certain frequently-used MSDOS functions from protected mode. 

Available on: 80386 or higher, Restrictions: Must be operating under DJ Delorie's 
GO32 DOS extender. 

Registers at call: Return Registers: varies by function 

AH = FFh 


AL = subfunction 
Olh create file 
02h open file 
03h get file statistics 
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04h get time of day 
OSh set time of day 
06h stat 
O7h system 
other varies by function 
Conflicts: Topware Network Operating System (chapter 27), "Sunday", "PSQR/1720", and "Ontario" viruses 
(chapter 34), CED (chapter 36), DOSED (chapter 36). 
See Also: INT 10h Function FFh (chapter 5). 


Ergo DOS Extenders 
Ergo Computing produces a number of DOS extenders; the following call is a general installation check for its 
extenders. 


INTERRUPT 2Fh - Function Ath 
Ergo DOS extenders - INSTALLATION CHECK 


Purpose: Determine whether one of the DOS extenders produced by Ergo Computing is installed. 
Available on: 80286 or higher. Restrictions: none. 
Registers at call: Return Registers: 
AH=AlIh If installed, first four bytes of ES:D] buffer are "TABH" 
AL = which: 
FEh OS/286,0S/386 
FFh HummingBoard DOS extender 
BX =008Ih 
ES:DI -> 16-byte buffer 
Conflicts: None known, but see Table 1-3 in chapter 1. 
See Also: Function FBAIh, INT 15h Function BFh Subfunction 02h 


Phar Lap DOS Extenders 
Recent versions of Phar Lap's DOS extenders have added the following call, which is a general installation check for 
its extenders. 


INTERRUPT 2Fh - Function EDh, Subfunction 00h 
DOS EXTENDER INSTALLATION CHECK 


Purpose: Determine whether a recent version of one of Phar Lap's DOS extenders is installed. 


Available on: 80286 or higher. Restrictions: none. 
Registers at call: Return Registers: 
AX = EDOOh AL = status 
BL = DOS extender 00h not installed 
Oh 286dosx v1.3+ (Software Development Kit) FFh installed 
02h 286dosx v1.3+ (Run-Time Kit) SI = 5048h ("PH") 
03h 386dosx v4.0+ (SDK) DI = 4152h ("AR") 
04h 386dosx v4.0+ (RTK) CH = major version number 
CL = minor version number 
DX = flags 


bit 0; running under DPMI 

bit 1: running under Phar Lap VMM 
Conflicts: None known. 
See Also: Function Alh, Function Flh Subfunction 00h, Function FBAIh 


Generic DOS extender installation check 

A number of DOS-extender vendors have agreed upon the following installation check, which will indicate whether 
a DOS extender is present, though not which one, To determine which DOS extender is present, a program must still 
query each installation check individually. 
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INTERRUPT 2Fh - Function Fih 
DOS EXTENDER INSTALLATION CHECK 


Purpose: Determine whether a DOS extender is present. 


Available on: 80286 or higher. Restrictions: none. 
Registers at call: Return Registers: 
AX =F100h AL = FFh if DOS extender present 


SI = 444Fh ("DO") 

DI = 5358h ("SX") 
Details: This function is supported or soon to be supported by DOS extenders from Phar Lap, Rational Systems, 
Ergo Computing, and IGC. 


Conflicts: None known, 
See Also: Function Alh, Function EDh Subfunction 00h, Function FBh Subfunction Alh, INT 15h Function BFh 


Subfunction 02h 


Borland DOS Extender 


With the introduction of Turbo Pascal version 6 and Borland C++ in February 1991, Borland International added a 
DOS extender to permit its compilers to compile files too large to be compiled in real mode. The protected-mode 
versions of the compilers will automatically load the extender, but the TKERNEL program may also be installed as a 


TSR to speed up the loading of the compiler. 


INTERRUPT 2Fh - Function FBA1h, Subfunction 0081h 
TKERNEL - INSTALLATION CHECK 


Purpose: Determine whether TRERNEL is installed, 


Available on: All machines. Restrictions: none. 

Registers at call: Return Registers: 

AX =FBAIh If installed, first four bytes of ES:DI buffer are "IABH" 
BX = 008!h 


ES:DI -> 16-byte buffer 
Conflicts: None known, but see Table 1-3 in chapter I. 
See Also: Function Alh, Function FBA1h Subfunctions 0082h and 0084h, INT 15h Function BFh Subfunction 02h 


INTERRUPT 2Fh - Function FBA1h, Subfunction 0082h 
TKERNEL - GET ENTRY POINT 


Purpose: Determine the address to call for the TKERNEL APL 


Available on: All machines, Restrictions: TKERNEL must be installed. 
Registers at call: Return Registers: 

AX =FBAIh ES:DI buffer filled 

BX = 0082h 


ES:DI -> response buffer (Table 9-6) 
Conflicts: None known, but see Table 1-3 in chapter 1. 
See Also: Function FBA1h Subfunctions 008 1h and 0084h 


Table 9-6. Format of response buffer: 


Offset Size Description 
00h 4BYTEs signature "[ABH" 
04h DWORD _ pointer to FAR extender entry point 


Call entry point with: 
AX = function number 
0000h to 0026h unknown. 
FFFFh unknown, 
BX:SI -> unknown, 
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CX:DI -> unknown. 
other 


Returns with: 
AX = 000Ih 
INTERRUPT 2Fh - Function FBAih, Subfunction 0084h 
TKERNEL - UNINSTALL 
Purpose: Remove TKERNEL from memory. 


Available on: All machines. Restrictions: TKERNEL must be installed. 
Registers at call: Return Registers: 

AX =FBAIh ES:DI buffer filled 

BX = 0084h 


ES:DI -> response buffer (Table 9-7) 
Conflicts: None known, but see Table 1-3 in chapter I. 
See Also: Function FBA 1h Subfunctions 008 Ih and 0084h 


Table 9-7, Format of response buffer: 


Offset Size Description 
00h 4BYTEs — signature "IABH" 
04h WORD success indicator: 


000ih failed (INT 2Fh hooked by another program 
unchanged if successful 


Oracle SQL Protected Mode Executive 


INTERRUPT 63h 
Oracle SQL Protected Mode Executive - Unknown Function 


Purpose: unknown. 


Available on: 80286 or higher. Restrictions: Oracle SQL Protected Mode Executive 
must be active, 
Registers at call: unknown. Return Registers: unknown. 


Conflicts: Adaptec and OMTI controllers - DRIVE 0 DATA (chapter 7), 4+4Power FLOPPY CONTROLLER 
(chapter 7), Also see table 1-2 in chapter 1, 


INTERRUPT 64h 
Oracle SQL Protected Mode Executive - Unknown Function 


Purpose: unknown. 


Available on: 80286 or higher, Restrictions: Oracle SQL Protected Mode Executive 
must be active. 

Registers at call: unknown. Return Registers: unknown, 

Conflicts: Adaptec controllers - DRIVE | DATA (chapter 7). Also see table 1-2 in chapter 1. 

DBOS 


DBOS is a DOS extender written at the University of Salford in England. 


INTERRUPT 78h - Function 03h 

SWITCH TO PROTECTED MODE 

Purpose: Begin execution in protected mode. 

Available on: 80286 or higher. Restrictions: University of Salford DBOS DOS 
extender must be active. 


| 
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Registers at call: Return Registers: unknown. 


AH = 03h 

other unknown. 

Details: DBOS supports functions 00h through 50h, but no information was available on the functions not listed here 
at the time of writing. 

Conflicts: TARGA.DEV 

See Also: Functions 1Eh and 22h, INT 15h Function 89h (chapter 3) 


INTERRUPT 78h - Function 1Eh 

SET REAL-MODE MEMORY SIZE 

Purpose: Specify how much real-mode memory to leave free when running FTN77 programs. 

Available on: 80286 or higher. Restrictions: University of Salford DBOS DOS 
extender must be active. 


Registers at call: Return Registers: unknown. 


AH = IEh 

other unknown. 

Details: DBOS supports functions 00h through 50h, but no information was available on the functions not listed here 
at the time of writing. 

Conflicts: None known. 

See Also: Functions 03h and 22h 


INTERRUPT 78h - Function 22h 


UNINSTALL 

Purpose: Remove DBOS from memory. 

Available on: 80286 or higher. Restrictions: University of Salford DBOS DOS 
extender must be active. 

Registers at call: Return Registers: unknown. 

AH = 22h 


other unknown, 

Details: DBOS supports functions 00h through 50h, but no information was available on the functions not listed here 
at the time of writing. 

Conflicts: None known. 

See Also: Functions 03h and [Eh 
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EMS, XMS, and VCPI 


In chapter 9, DOS extenders were presented as a means of using more memory than is ordinarily available to real- 
mode DOS programs. This chapter covers three additional ways to access additional memory. 
Because of the numerical ordering of the interrupts, the three sections of this chapter are arranged in the order 


XMS, EMS, and VCPI. 


XMS 


The Extended Memory Specification gives access to extended memory and noncontiguous, non-EMS memory above 
the 640K point. It provides controlled access to extended memory, unlike BIOS INT 15h Functions 87h and 88h, thus 
permitting applications to share extended memory without conflicts, XMS is provided by Microsoft’s HIMEM.SYS 
and most 386 memory managers (such as 386M AX or QEMM-386). 





INTERRUPT 2Fh - Function 43h, Subfunction 00h 


INSTALLATION CHECK 

Purpose: Determine whether XMS high-memory management software is present, 
Available on: All machines. Restrictions: none. 

Registers at call: Return Registers: 

AX = 4300h AL = 80h XMS driver installed 


AL<>80h no driver 
Details: This installation check does not follow the format used by other software. 
Conflicts: None known. 
See Also: Function 43h Subfunction 10h 


INTERRUPT 2Fh - Function 43h, Subfunction 10h 


GET XMS DRIVER ADDRESS 

Purpose: Obtain address of XMS driver in order to use its functions. 

Available on: 80286 and up systems only. Restrictions: XMS software must be installed. 
Registers at call: Return Registers: 

AX = 4310h ES:BX - > driver entry point 


Details: HIMEM.SYS requires at least 256 bytes of free stack space. Perform a FAR call to the driver entry point 
with AH set to the function code. 
Code/Function/Regs: Returns: 
00h Get XMS version number AX = XMS version (in BCD) 
BX = internal revision number 
DX = 000Ih if HMA (1M to IM + 64K) exists 
0000h if HMA does not exist 


Oth Request High Memory Area (1M to 1M + AX = 0001h success 
64K) 0000h failure 
DX = memory in bytes (for TSR or device BL = error code (Table 10-1) 
drivers) 


FFFFh if application program 
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02h Release High Memory Area 


03h Global enable A20, for using the HMA 


04h Global disable A20 





05h Local enable A20, for direct access to 
extended memory 


06h Local disable A20 


07h Query A20 state 


O8h Query free extended memory, not counting 
HMA 


09h Allocate extended memory block 
DX = Kbytes needed 


OAh Free extended memory block 
DX = handle of block to free 


OBh Move extended memory block 
DS:SI -> EMM structure (Table 10-2). Note: if 
either handle is 0000h, the corresponding 
offset is considered to be an absolute 
segment:offset address in directly 
addressable memory 


OCh Lock extended memory block 
DX = handle of block to lock 


ODh Unlock extended memory block 
DX = handle of block to unlock 


AX= 0001h success 
0000h failure 
BL = error code (Table 10-1) 


AX= 000Ih success 
0000h failure 
BL = error code (see below) 


AX= 0001h success 
0000h failure 
BL = error code (see below) 


AX = 000Ih success 
0000h failure 
BL = error code (see below) 








AX= 0001h success 
0000h failure 
BL = error code (see below) 





AX= 0001h enabled 
0000h disabled 
BL = error code (0 = successful) 





AX = size of largest extended memory block in K 
DX = total extended memory in K 
BL = error code (see below) 


AX= 0001h success 
DX = handle for memory block 
0000h failure 
BL = error code (see below) 


AX= 0001h success 
0000h failure 
BL = error code (see below) 


AX= 0001h success 
0000h failure 
BL = error code (see below) 


AX= 000Ih success 
DX:BX = 32-bit linear address of locked 
block 
0000h failure 
BL = error code (see below) 


AX = 0001h success 
0000h failure 
BL = error code (see below) 


OEh Get handle information 
DX = handle for which to get 
info 


OFh Reallocate extended memory block 
DX = handle of block 
BX = new size of block in K 


10h Request upper memory block (nonEMS 
memory above 640K) 
DX = size of block in paragraphs 


11h Release upper memory block 
DX = segment address of UMB to release 


Conflicts: None known. 
See Also: Function 43h Subfunction 00h 


Table 10-1. Values of error codes returned in BL: 


80h — Function not implemented 
81h  Vdisk was detected 

82h An A20 error occurred 
8Eh a general driver error 

8Fh unrecoverable driver error 
90h = HMA does not exist 

91h HMA is already in use 


92h DX is less than the /AMAMINE= parameter 


93h HMA is not allocated 

94h — A20 line still enabled 

AOh all extended memory is allocated 

Ath — all available extended memory handles are 
allocated 

A2h — Invalid handle 





Table 10-2. Format of EMM structure: 
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AX= 000/h success 
BH = block's lock count 
BL = number of free handles left 
DX = block size in K 
0000h failure 
BL = error code (see below) 


AX= 0001h success 
0000h failure 
BL = error code (see below) 


AX= 0001h success 

BX = segment address of UMB 
DX = actual size of block 
0000h failure 

BL = error code (see below) 
DX = largest available block 





AX = 000Ih success 
0000h failure 
BL = error code (see below) 


A3h — Source handle is invalid 

A4h — Source offset is invalid 

A5h Destination handle is invalid 
A6h Destination offset is invalid 

A7h Length is invalid 

A8h = Move has an invalid overlap 
A9h Parity error occurred 

AAh Block is not locked 

ABh Block is locked 

ACh Block lock count overflowed 
ADh Lock failed 

BOh Only a smaller UMB is available 
Blh No UMB's are available 

B2h UMB segment number is invalid 
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Offset Size Description 

00h DWORD number of bytes to move (must be even) 

04h WORD source handle 

06h DWORD _ offset into source block 

OAh WORD destination handle 

0Ch DWORD offset into destination block | 
CIM EMS 


The Lotus/Intel/Microsoft Expanded Memory Specification 3.2 is the original interface to bank-switched memory 
allowing programs to use more memory than is addressable in real mode. Two additional variants of the specification | 
(EEMS and LIM EMS 4.0) were later created to address shortcomings in the original standard. The calls in this i 
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section are supported by all three extant variants of EMS; the following sections cover additional calls supported by 
EEMS and EMS 4.0. 


INTERRUPT 67h - Function 40h 


GET MANAGER STATUS 

Purpose: Determine whether the expanded memory hardware is functioning properly. 

Available on: All machines. Restrictions: This call can only be used after 
establishing that the EMS driver is in 
fact present. 

Registers at call: Return Registers: 

AH = 40h AH = status 


00h successful 

80h internal error 

8th hardware malfunction 

84h undefined function requested by application 
Conflicts: None known. 


INTERRUPT 67h - Function 41h 


GET PAGE FRAME SEGMENT 

Purpose: Determine the segment address at which the first four 16K physical pages are located. 

Available on: All machines. Restrictions: LIM EMS driver must be installed. 
Registers at call: Return Registers: 

AH=4l1h AH = 00h function successful 


BX = segment of page frame 
AH = error code (see Function 40h) 
Details; EEMS and LIM EMS 4 may provide additional physical pages into which EMS may be mapped; these 
additional pages need not be contiguous or even located at a higher address than the page frame. 
Conflicts: None known, 
See Also: EEMS Function 68h, LIM EMS 4 Function 58h 


INTERRUPT 67h - Function 42h 
GET NUMBER OF PAGES 


Purpose: Determine how many 16K pages of memory are available for allocation, and the total number of pages 
present in the system. 


Available on: All machines. Restrictions: LIM EMS driver must be installed. 
Registers at call: Return Registers: 
AH = 42h AH = 00h function successful 


BX = number of unallocated pages 
DX = total number of pages 
AH = error code (see Function 40h) 
Conflicts: None known. 


INTERRUPT 67h - Function 43h 

GET HANDLE AND ALLOCATE MEMORY 

Purpose: Request a number of 16K logical pages and associate them with a unique identifier which will later be 
used to manipulate those pages. 

Available on: All machines. Restrictions: LIM EMS driver must be installed. 
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Registers at call: Return Registers: 

AH = 43h AH = status 

BX = number of logical pages to allocate 00h function successful 
DX = handle 


80h internal error 
81h hardware malfunction 
84h undefined function requested 
85h no more handles available 
87h more pages requested than physically exist 
88h more pages requested than currently available 
89h zero pages requested 
Conflicts: None known. 
See Also: Function 45h 


INTERRUPT 67h - Function 44h 


MAP MEMORY 

Purpose: Specify an association between a physical page of addresses and a logical page of expanded memory. 
Available on: All machines. Restrictions: LIM EMS driver must be installed. 
Registers at call: Return Registers: 

AH = 44h AH & status 

AL = physical page number (0-3) 00h function successful 

BX = logical page number 80h internal error 

DX = handle 8th hardware malfunction 


83h invalid handle 
84h undefined function requested 
8Ah invalid logical page number 
8Bh illegal physical-page number 
Conflicts: None known. 
See Also: Function 69h 


INTERRUPT 67h - Function 45h 
RELEASE HANDLE AND MEMORY 


Purpose: Deallocate pages previously associated with an expanded memory identifier and invalidate the identifier. 


Available on: All machines. Restrictions: LIM EMS driver must be installed. 
Registers at call: Return Registers: 

AH = 45h AH = status 

DX = BMM handle 00h successful 


80h internal error 

81h hardware malfunction 

83h invalid handle 

84h undefined function requested 

86h error in save or restore of mapping context 
Conflicts: None known, 
See Also: Function 43h 


INTERRUPT 67h - Function 46h 
GET EMM VERSION 


Purpose: Determine which version of the memory management software is installed. 
Available on: All machines. Restrictions: LIM EMS driver must be installed. 





| 
| 
| 
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Registers at call: Return Registers: 
AH = 46h AH = status 

00h successful 

AL = EMM version number (high 
nybble=major, low nybble=minor) 

80h internal error 

8th hardware malfunction 

84h undefined function requested 
Conflicts; None known. 


INTERRUPT 67h - Function 47h 


SAVE MAPPING CONTEXT 

Purpose: Save the current set of associations between physical and logical pages for later restoration. 
Available on: All machines. Restrictions: LIM EMS driver must be installed. 
Registers at call: Return Registers: 

AH =47h AH = status 

DX = handle 00h successful 


80h internal error 
81h hardware malfunction 
83h invalid handle 
84h undefined function requested 
8Ch page-mapping hardware state save area is full 
8Dh save of mapping context failed 
Conflicts: None known. 
See Also: Function 47h 


INTERRUPT 67h - Function 48h 
RESTORE MAPPING CONTEXT 


Purpose: Restore the most recently saved set of associations between physical and logical pages. 


Available on: All machines. Restrictions: LIM EMS driver must be installed. : 
Registers at call: AH = status : 
AH = 48h 00h successful : 
DX = handle 80h internal error ' 
81h hardware malfunction 
83h invalid handle 


84h undefined function requested 
8Eh restore of mapping context failed 
Conflicts: None known. 
See Also: Function 47h 


INTERRUPT 67h - Function 49h 
reserved » GET /0 PORT ADDRESSES 


Purpose: This function has been removed from the specification, 


Available on: Ali machines. Restrictions: LIM EMS driver must be installed. 
Registers at call: Return Registers: n/a 
AH = 49h 


Details: This function was defined in EMS 3.0, but became undocumented in EMS 3.2, 
Conflicts: None known. 


INTERRUPT 67h - Function 4Ah 


reserved - GET TRANSLATION ARRAY 


Purpose: This function has been removed from the specification. 
Available on: All machines. Restrictions: LIM EMS driver must be installed. 


i 
i 
{ 
{ 
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Registers at call: Return Registers: n/a 


AH=4Ah 
Details: This function was defined in EMS 3.0, but became undocumented in EMS 3.2. 


Conflicts: None known. 


INTERRUPT 67h - Function 4Bh 
GET NUMBER OF EMM HANDLES 


Purpose: Determine how many expanded memory handles are currently in use. 


Available on: All machines. Restrictions: LIM EMS driver must be installed. 
Registers at call: Return Registers: 
AH =4Bh AH = status 


00h successful 
BX = number of EMM handles 
80h internal error 
81h hardware malfunction 
83h invalid handle 
84h undefined function requested 


Conflicts: None known. 


INTERRUPT 67h - Function 4Ch 
GET PAGES OWNED BY HANDLE 


Purpose: Determine how many pages of memory are allocated to the specified expanded memory handle. 


Available on: All machines. Restrictions: LIM EMS driver must be installed. 
Registers at call: Return Registers: 
AH =4Ch AH = status 


DX = EMM handle 
00h successful 


BX = number of logical pages 
80h internal error 
8th hardware malfunction 
83h invalid handle 
84h undefined function requested 
Conflicts: None known. 
See Also: Function 4Dh 


INTERRUPT 67h - Function 4Dh 
GET PAGES FOR ALL HANDLES 


Purpose: Determine all active expanded memory handles and how many pages of memory are allocated to each, 


Available on: All machines. Restrictions: LIM EMS driver must be installed. 
Registers at call: Return Registers: 

AH =4Dh AH = status 

ES:DI -> array to receive information 00h successful 


BX = number of active EMM handles 
array filled with 2-word entries, consisting 
of a handle and the number of pages 
allocated to that handle 
80h internal error 
81h hardware malfunction 
84h undefined function requested 


Conflicts: None known. 
See Also: Function 4Ch 
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INTERRUPT 67h - Function 4Eh 
GET OR SET PAGE MAP 


Purpose: Save or restore the current set of associations between physical and logical pages using an application- 
provided data area. 
Available on: All machines. Restrictions: LIM EMS driver must be installed. 
Registers at call: Return Registers: 
AH = 4Eh AH = status 
AL = 00h if getting mapping registers 00h successful 
Oh if setting mapping registers array pointed to by ES:DI receives mapping 
02h if getting and setting mapping registers at info (AL=00h/02h) 


once AL = bytes in page-mapping array (AL=03h 
O3h if getting size of page-mapping array only) 
DS:SI -> array holding information 80h internal error 
(AL=01/02) 81h hardware malfunction 
ES:DI -> array to receive information 84h undefined function requested 


{AL=00/02) 8Fh undefined subfunction parameter 
A3h contents of source array corrupted (EMS 4.0?) 
Details: This function was designed to be used by multitasking operating systems and should not ordinarily be used 
by appplication software. 
Conflicts: None known. 
See Also: Function 4Fh 


LIM EMS 4.0 

EMS version 4.0 is the third variant of the Expanded Memory Specification to be defined. It adds most of the 
capabilities of EEMS to the basic EMS 3.2 function calls, then extends the command set even further, The functions 
in this section are only available with drivers conforming to version 4.0 of the specification, It should be noted, 
however, that drivers can conform to EMS 4.0 without having the extra hardware mandated by EEMS; this creates 
confusion when attempting to select an expanded memory board, since some programs such as multitaskers require 
more than four mappable pages. 


INTERRUPT 67h - Function 4Fh 
GET/SET PARTIAL PAGE MAP 


Purpose: Save or restore the current associations between physical and logical pages, using an application-provided 
data area, for a subset of all physical pages. 


Available on: All machines. 
Registers at call: 

AH = 4Fh 

AL & subfunction: 


00h get partial page map 
DS:SI -> structure containing list of segments 
whose mapping contexts are to be saved 
ES:DI -> array to receive page map 


Oth set partial page map 
DS:SI -> structure containing saved partial page 
map 


02h get size of partial page map 
BX = number of mappable segments in the 
partial map to be saved 
Conflicts: None known. 


Restrictions: LIM 4.0 EMS driver must be installed, 
Return Registers: 
AH = status 


00h successful 

80h internal error 

81h hardware malfunction 

84h undefined function requested 

8Bh one of specified segments is not mappable 

8Fh undefined subfunction parameter 

A3h contents of partial page map corrupted or 
count of mappable segments exceeds total 
number of mappable segments in system 


AL= size of partial page map for subfunction 02h 





| 
i 
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See Also: Function 4Eh 


INTERRUPT 67h - Function 50h 
MAP/UNMAP MULTIPLE HANDLE PAGES 


Purpose: Create or remove associations between a set of physical and logical pages. 


Available on: All machines. Restrictions: LIM 4.0 EMS driver must be installed. 
Registers at call: Return Registers: 
AH = 50h AH = status 
AL = subfunction 00h successful 
00h use physical page numbers 80h internal error 
Oth use segment adresses 8th hardware malfunction 
DX = handle 83h invalid handle 
CX = number of entries in array 84h undefined function requested 
DS:SI -> mapping array 8Ah one or more logical pages are invalid 


8Bh one or more physical pages are invalid 
8Fh invalid subfunction 


Conflicts: None known. 
See Also: Function 40h 


INTERRUPT 67h - Function Sih 


REALLOCATE PAGES 

Purpose: Modify the number of logical pages assigned to an expanded memory handle. 

Available on: All machines. Restrictions: LIM 4.0 EMS driver must be installed. 
Registers at call: Return Registers: 

AH = 5th BX = actual number of pages allocated to handle 
DX = handle AH 5 status 

BX = number of pages to be allocated to handle 00h successful 


80h internal error 

81h hardware malfunction 

83h invalid handle 

84h undefined function requested 

87h more pages requested than present in system 
88h more pages requested than currently available 


Conflicts: None known. 


INTERRUPT 67h - Function 52h 
GET/SET HANDLE ATTRIBUTES 


Purpose: Determine or change the attribute associated with an expanded memory handle. 


Available on: All machines. Restrictions: LIM 4.0 EMS driver must be installed. 
Registers at call: Return Registers: 

AH = 52h AH = status 

DX = handle 00h successful 

AL = subfunction: 80h internal error 


81h hardware malfunction 
83h invalid handle 
84h undefined function requested 
8Fh undefined subfunction 
90h undefined attribute type 
91h feature not supported 
00h get handle attributes AL = attribute 
00h handle is volatile 
Oth handle is nonvolatile 
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O1h set handle attributes 
BL = new attribute: 
00h handle is volatile 
O1h handle is nonvolatile 
02h get attribute capability AL = attribute capability 
00h only volatile handles supported 
01h both volatile and non-volatile supported 
Conflicts: None known. 
See Also: Function 53h 


INTERRUPT 67h - Function 53h 
GET/SET HANDLE NAME 


Purpose: Determine or set the eight-character name which may be used to identify the specified expanded memory 
handle. 


Available on: All machines. Restrictions: LIM 4.0 EMS driver must be installed. 
Registers at call: Return Registers: 
AH =53h AH = status 
DX = handle 00h successful 
AL = subfunction: 80h internal error 
00h get handle name 81h hardware malfunction 
ES:DI -> 8-byte handle name array 83h invalid handle 
Olh set handle name 84h undefined function requested 
DS:SI -> 8-byte handle name 8Fh undefined subfunction 


Ath duplicate handle name 
Conflicts: None known. 
See Also: Function 52h 


INTERRUPT 67h - Function 54h 


GET HANDLE DIRECTORY 
Purpose: Get a list of active expanded memory handles and the names which have been assigned to them. 
Available on: All machines. Restrictions: LIM 4.0 EMS driver must be installed. 
Registers at call: Return Registers: 
AH = 54h AH = status 
AL = subfunction: 00h successful 
80h internal error 
81h hardware malfunction 
84h undefined function requested 
8Fh undefined subfunction 
AOh no such handle name 
Alba handle found had no name 
00h get handle directory AL = number of entries in handle directory 


ES:DI -> buffer for handle directory 
(Table 10-3) 


O1h search for named handle DX = value of named handle 
DS:SI -> 8-byte name 
02h get total number of handles BX = total number of handles 


Conflicts: None known, 


Table 10-3. Format of handle directory entry: 


Offset Size Description 
00h WORD expanded memory handle 
02h 8BYTEs name assigned to handle 
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INTERRUPT 67h - Function 55h 
ALTER PAGE MAP AND JUMP 


Purpose: Change the association between specified physical pages and logical pages, then perform a far jump to the 
given address, 


Available on: All machines. Restrictions: LIM 4.0 EMS driver must be installed. 
Registers at call: Return Registers: (at target address unless error) 
AH = 55h AH = status 
AL = subfunction: OOh successful 
80h internal error 
00h physical page numbers provided by caller 81h hardware failure 
83h invalid handle 
Oth segment addresses provided by caller 84h undefined function requested 
DX = handle 8Ah invalid logical page number encountered 
DS:SI -> structure containing map and jump address 8Bh invalid physical page number encountered 


8Fh invalid subfunction 
Conflicts: None known. 
See Also: Function 56h 


INTERRUPT 67h ~ Function 56h 
ALTER PAGE MAP AND CALL 


Purpose: Change the association between specified physical pages and logical pages for the duration of a far call to 
the given address. 


Available on: All machines. Restrictions: LIM 4.0 EMS driver must be installed. 
Registers at call: Return Registers: (if successful, the target address is 
AH = 56h called. Use a RETF to return and restore mapping 
AL = subfunction: context) 


AH = status (see Function 55h) 
00h physical page numbers provided by caller 
DX = handle 
DS:SI -> structure containing page map and call 
address 
Olh segment addresses provided by caller 
DX = handle 
DS:S] -> structure containing page map and call 
address 
02h get page map stack space required BX = stack space required 
Conflicts: None known. 
See Also: Function 55h 


INTERRUPT 67h - Function 57h 

MOVE/EXCHANGE MEMORY REGION 

Purpose: Copy or swap the contents of a region of memory; the source and destination may both be either 
conventional or expanded memory. 


Available on: All machines. Restrictions: LIM 4.0 EMS «river must be installed. 
Registers at call: Return Registers: 

AH = 37h AH & status 

AL = subfunction 00h successful 

00h move memory region 80h internal error 


81h hardware failure 


1 
i 
| 
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Olh exchange memory region 83h invalid handle 
DS:SI -> structure describing source and 84h undefined function requested 
destination (Table 10-4) 8Ah invalid logical page number encountered 


8Fh undefined subfunction 
92h successful, but a portion of the source region 
has been overwritten 
93h length of source or destination region exceeds 
length of region allocated to either source or 
destination handle 
94h conventional and expanded memory regions 
overlap 
95h offset within logical page exceeds size of 
logical page 
96h region length exceeds IM 
97h source and destination EMS regions have same 
handle and overlap 
98h memory source or destination type undefined 
A2h attempted to wrap around 1M conventional 
address space 
Details: The source and destination of a move may overlap, in which case the copy direction is chosen such that the 
destination receives an intact copy of the source region. 
Conflicts: None known. 


Table 10-4. Format of EMS copy data: 


Offset Size Description 
00h DWORD _ region length in bytes 
04h BYTE source memory type 


Table 10-4. Format of EMS copy data (continued) 


Offset Size Description 
00h conventional 
Olh expanded 
05h WORD source handle (0000h if conventional memory) 
07h WORD source initial offset (within page if EMS, segment if convent) 
09h WORD source initial segment (conv mem) or logical page (EMS) 
OBh BYTE destination memory type 
00h conventional 
Oih expanded 
0Ch WORD destination handle 
OEh WORD destination initial offset 
10h WORD destination initial segment or page 


INTERRUPT 67h - Function 58h 
GET MAPPABLE PHYSICAL ADDRESS ARRAY 


Purpose: Determine the segment and physical page number of each mappable 16K physical page in the system. 
Available on: All machines. Restrictions: LIM 4.0 EMS driver must be installed. 
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Registers at call: Return Registers: 
AH = 58h CX = number of entries (Table 10-5) in array 
AL = subfunction: AH & status 
00h successful 
00h get mappable physical address array 80h internal error 
ES:DI -> buffer to be filled with array 8th hardware failure 
84h undefined function requested 
Olh get number of entries in m.p.a. array 8Fh undefined subfunction 


Details: The returned array for subfunction 00h is filled in physical segment address order. 
Conflicts: None known. 
See Also: EEMS Function 68h 


Tabte 10-5, Format of mappable physical address entry: 


Offset Size Description 
00h WORD physical page segment 
02h WORD physical page number 


INTERRUPT 67h - Function 59h 
GET EXPANDED MEMORY HARDWARE INFORMATION 


Purpose: Determine the expanded memory hardware's capabilities. 


Available on: All machines. Restrictions: LIM 4.0 EMS driver must be installed. 
Registers at call: Return Registers: 
AH = 59h AH & status 
DX = total raw pages 00h successful 
AL = subfunction: 80h internal error 
81h hardware failure 
Oh get hardware configuration array 84h undefined function requested 
ES:DI -> buffer to be filled with array 8Fh undefined subfunction 
(Table 10-6) A4h access denied by operating system 
Olh get unallocated raw page count BX = unallocated raw pages 


Details: Subfunction OOh is for use by operating systems only, and can be enabled or disabled at any time by the 
operating system. 
Conflicts; None known. 


Table 10-6. Format of hardware configuration array: 


Offset Size Description 

00h WORD size of raw EMM pages in paragraphs 

02h WORD number of alternate register sets 

04h WORD size of mapping-context save area in bytes 
06h WORD number of register sets assignable to DMA 
08h WORD DMA operation type: 


0000h DMA with alternate register sets 
0001h only one DMA register set 


INTERRUPT 67h - Function 5Ah 
ALLOCATE STANDARD/RAW PAGES 
Purpose: Reserve a specified number of pages (possibly of a nonstandard size) and associate them with a unique 


expanded memory handle. 
Available on: All machines. Restrictions: LIM 4.0 EMS driver must be installed. 
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Registers at call: 
AH =5Ah 
AL = subfunction: 
00h allocate standard pages 


Olh allocate raw pages 
BX = number of pages to allocate 


Conflicts: None known. 


INTERRUPT 67h - Function 5Bh 
ALTERNATE MAP REGISTER SET 


Return Registers: 
DX = handle 
AH = status 


00h successful 

80h internal error 

8ih hardware failure 

84h undefined function requested 

85h no more handles available 

87h insufficient memory pages in system 
88h insufficient memory pages available 
8Fh undefined subfunction 


Purpose: Use or simulate multiple sets of hardware mapping registers, 


Available on: All machines. 
Registers at call: 

AH =5Bh 

AL = subfunction: 


Oh get alternate map register set 


Olh set alternate map register set 
BL = new alternate map register set number 
ES:DI -> map register context save area if 
BL=0 
02h get alternate map save array size 


03h allocate alternate map register set 


04h deallocate alternate map register set 
BL = number of alternate map register set 


Restrictions: LIM 4.0 EMS driver must be installed. 
Return Registers: 
AH = status 


00h successful 

80h internal error 

81h hardware malfunction 

84h undefined function requested 

8Fh undefined subfunction 

9Ah specified alternate map register set not 
supported 

9Bh all alternate map register sets currently 
allocated 

9Ch alternate map register sets not supported 

9Dh undefined or unallocated alternate map 
register set 

A3h source array corrupted 

A4h operating system denied access 


BL = current active alternate map register set 


number 


ES:DI -> map register context save area if BL=00h ; 


DX = array size in bytes 


BL = number of map register set; 00h = not supported 


Details: This function is for use by operating systems only, and can be enabled or disabled at any time by the 


operating system. 
Conflicts: None known. 
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ALTERNATE MAP REGISTER SET - DMA REGISTERS 
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Purpose: Manage the use of mapping registers with direct memory accesses by other hardware. 


Available on: All machines. 

Registers at call: 

AH = 5Bh 

AL = subfunction: 

05h allocate DMA register set 

06h enable DMA on alternate map register set 
BL = DMA register set number 
DL = DMA channel number 

O7h disable DMA on alternate map register set 
BL = DMA register set number 

08h deallocate DMA register set 


Restrictions: LIM 4.0 EMS driver must be installed. 
Return Registers: 
AH & status 


00h successful 

80h internal error 

81h hardware malfunction 

84h undefined function requested 

8Fh undefined subfunction 

9Ah specified DMA register set not supported 
9Bh all DMA register sets currently allocated 
9Ch alternate DMA sets not supported 


9Dh undefined or unallocated DMA register set 
9Eh dedicated DMA channels not supported 
9Fh specified dedicated DMA channel not 
supported 
A3h source array corrupted 
A4h operating system denied access 
BL = DMA register set number (subfunction 0Sh 
only), 


BL = DMA register set number 


00h if not supported 
Details: This function is for use by operating systems only, and can be enabled or disabled at any time by the 
operating system. 
Conflicts: None known. 


INTERRUPT 67h - Function 5Ch 
PREPARE EXPANDED MEMORY HARDWARE FOR WARM BOOT 


Purpose: Place the expanded memory hardware into readiness for an impending warm boot. 
Available on: All machines. Restrictions: LIM 4.0 EMS driver must be installed. 
Registers at call: Return Registers: 
AH = 5Ch AH = status 
00h successful 
80h internal error 
81h hardware malfunction 
84h undefined function requested 
Conflicts: None known. 


INTERRUPT 67h - Function 5Dh 


ENABLE/DISABLE OS FUNCTION SET FUNCTIONS 


Purpose: Specify whether applications may use LIM EMS 4.0 functions designed for use by the operating system. 
Available on: All machines. Restrictions: LIM 4.0 EMS driver must be installed. 
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Registers at call: Return Registers: 
AH=5Dh BX,CX = access key, returned only on first invocation 
AL = subfunction: of function 
00h enable OS Function Set AH = status 
00h successful 
O1h disable OS Function Set 80h internal error 
81h hardware malfunction 
02h return access key (resets memory manager, 84h undefined function requested 
returns access key at next invocation) 8Fh undefined subfunction 
BX,CX = access key returned by first Ad4h operating system denied access 
invocation 
Conflicts: None known. 
EEMS 


The Enhanced Expanded Memory Specification by Ashton-Tate, Quarterdeck, and AST addresses some of the 
perceived deficiences in version 3.2 of the Expanded Memory Specification. The additional capabilities of EEMS 
were later added to EMS version 4.0, but using different calls. 


INTERRUPT 67h - Function 60h 
GET PHYSICAL WINDOW ARRAY 


Purpose: Determine where in memory pages are mapped. 


Available on: All machines. Restrictions: EEMS driver must be installed. 
Registers at call: Return Registers: 

AH = 60h AH = status 

ES:DI -> buffer AL = number of entries 


buffer at ES:DI filled 
Conflicts: None known. 


INTERRUPT 67h - Function 6th 
GENERIC ACCELERATOR CARD SUPPORT 


Purpose: Can be used by an accelarator card manufacturer to flush a RAM cache, ensuring that the cache accurately 
reflects what the processor would see without the cache. 


Available on: All machines. Restrictions: EEMS driver must be installed. 
Registers at call: Return Registers: unknown. 

AH=6lh 

Others unknown, 


Conflicts: None known. 


INTERRUPT 67h - Function 68h 
GET ADDRESSES OF ALL PAGE FRAMES IN SYSTEM 


Purpose: Determine where in memory pages may be mapped. 


Available on: All machines. Restrictions: EEMS driver must be installed. 
Registers at call: Return Registers: 

AH = 68h AH = status 

ES:DI -> buffer AL = number of entries 


buffer at ES:DI filled 
Conflicts: None known. 
See Also: LIM EMS 4 Function 58h 


INTERRUPT 67h - Function 69h 


MAP PAGE INTO FRAME 


Purpose: Make a logical page of memory addressable as real memory at a specified location. 
Available on: All machines. Restrictions: EEMS driver must be installed. 


Registers at call: 
AFT = 69h 
rame number 





DX = handle 

Details: Similar to EMS function 44h. 
Conflicts: None known, 

See Also: Functions 44h, 50h, and 6Ah 


INTERRUPT 67h - Function 6Ah 
PAGE MAPPING 
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Return Registers: 
AH = status 


Purpose: Save or restore the associations between a set of physical addresses and logical addresses. 


Available on: All machines. 
Registers at call: 
AH =6Ah 
AL = subfunction: 
00h save partial page map 

CH = first page frame 

CL = number of frames 

ES:DI -> buffer which is to be filled 
OLh restore partial page map 

CH = first page frame 

CL = number of frames 

DI:SI -> previously saved page map 
02h save and restore partial 

page map 

CH = first page frame 

CL = number of frames 

ES:DI = buffer for 

current page map 

DI:SI = new page map 
03h get size of save array 

CH = first page frame 

CL = number of frames 
04h switch to standard map register setting 
O5h switch to alternate map register setting 
06h deallocate pages mapped to frames in 

conventional memory 
CH = first page frame 
CL = number of frames 





Restrictions: EEMS driver must be installed. 


Return Registers: 
AH & status 


AL = size of array in bytes 


Details: Similar to LIM EMS function 4Eh, except that a subrange of pages can be specified. 


Conflicts: None known. 
See Also: 


Virtual Control Program Interface 





VCPI was created out of the need to have multiplex 386 protected-mode supervisors (such as a multitasker and a 
DOS extender) coexist. It provides rudimentary services which will allow a master supervisor program to stay in 
control of the system while still permitting other programs access to protected mode. 

The VCPI specification contains only a small set of services; for a more complete set, see the DOS Protected-Mode 
Interface in chapter 11. DPMI is unfortunately incompatible with VCPI. 
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INTERRUPT 67h - Function DEh, Subfunction 00h 


INSTALLATION CHECK 

Purpose: Determine whether a Virtual Control Program Interface (VCPI) master program is installed. 
Available on: All machines. Restrictions: none, 

Registers at call: Return Registers: 

AX = DEOOh AH=00h VCPI is present 


BH = major version number 
BL = minor version number 
AH nonzero VCPI not present 
Conflicts: None known, 


INTERRUPT 67h - Function DEh, Subfunction 0th 
GET PROTECTED MODE INTERFACE 


Purpose: Determine the entry point for accessing VCPI services in protected mode. 


Available on: 80386 or higher. Restrictions: VCPI must be installed. 
Registers at call: Return Registers: 
AX =DEO0Ih AH = 00h successful 
ES:DI -> 4K page table buffer DI -> first unused page table entry in buffer 
DS:SI -> three descriptor table entries in GDT: first EBX -> protected mode entry point in code 
becomes code segment descriptor, other two for segment 
use by main control program. AH = nonzero failed 


Conflicts: None known, 


INTERRUPT 67h - Function DEh, Subfunction 02h 
GET MAXIMUM PHYSICAL MEMORY ADDRESS 


Purpose: Determine highest page which could be allocated in order to initialize memory management structures. 


Available on: 80386 or higher. Restrictions: VCPI must be installed. 
Registers at call: Return Registers: 
AX = DEO2h AH = 00h successful 
EDX = physical address of highest 4K memory 
page 


AH nonzero: failed 
Conflicts: None known. 


INTERRUPT 67h - Function DEh, Subfunction 03h 
GET NUMBER OF FREE 4K PAGES 


Purpose: Determine how much memory is still available for allocation. 


Available on; 80386 or higher. Restrictions: VCPI must be installed. 
Registers at call: Return Registers: 
AX = DEO3h AH = 00h successful 


EDX = number of free 4K pages 
AH nonzero: failed 


Details: Returns total number of pages available to ALL tasks in system. Also available in protected mode by calling 


the protected-mode VCPI entry point. 
Conflicts: None known. 
See Also: Function DEh Subfunction 04h 


INTERRUPT 67h - Function DEh, Subfunction 04h 
ALLOCATE A 4K PAGE 


Purpose: Reserve a single page of memory. 
Available on: 80386 or higher. Restrictions: VCPI must be installed. 
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Registers at call: Return Registers: 
AX = DEO4h AH = 00h successful 
EDX = physical address of allocated page 

AH nonzero: failed 
Details: The client program is responsible for freeing all memory allocated with this call before terminating. Also 
available in protected mode by calling the protected-mode VCPI entry point. 
Conflicts: None known. 
See Also: Function DEh Subfunctions 03h and 05h 


INTERRUPT 67h « Function DEh, Subfunction 05h 


FREE 4K PAGE 

Purpose: Return the specified page of memory to the system. 

Available on: 80386 or higher. Restrictions: VCPI must be installed. 
Registers at call: Return Registers: 

AX = DE0S5h AH = 00h successful 

EDX = physical address of 4K page AH nonzero: failed 


Details: Also available in protected mode by calling the protected-mode VCPI entry point. 
Conflicts: None known. 
See Also: Function DEh Subfunction 04h 


INTERRUPT 67h - Function DEh, Subfunction 06h 
GET PHYSICAL ADDRESS OF PAGE IN FIRST MB 


Purpose: Determine the physical address of a logical page within the one-megabyte Virtual-86 mode address space. 


Available on: 80386 or higher. Restrictions: VCPI must be installed. 
Registers at call Return Registers: 
AX = DEOGh AH = 00h successful 
CX = page number (linear address shifted right 12 EDX = physical address of page 
bits) AHI nonzero: invalid page number (AH = 8Bh 
recommended) 


Conflicts: None known. 


INTERRUPT 67h - Function DEh, Subfunction 07h 


READ CRO 

Purpose: Determine value of CPU Control Register 0; in Virtual-86 mode this register is normally inaccessible. 
Available on: 80386 or higher. Restrictions: VCPI must be installed. 

Registers at call: Return Registers: 

AX = DEO7h AH = 00h 


EBX = value of Control Register 0 
Conflicts: None known. 
See Also: Function DEh Subfunction 07h 


INTERRUPT 67h - Function DEh, Subfunction 08h 


READ DEBUG REGISTERS 

Purpose: Determine the current contents of the CPU's debugging registers. 

Available on: 80386 or higher. Restrictions: VCPI must be installed. 

Registers at call: Return Registers: 

AX = DEO8h AH = 00h 

ES:DI -> array of 8 DWORDs buffer filled with DRO first, DR7 last, DR4 and DRS 


unused 
Conflicts: None known. 
See Also: Function DEh Subfunction 09h 
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INTERRUPT 67h - Function DEh, Subfunction 09h 


SET DEBUG REGISTERS 

Purpose: Specify new contents for the CPU's debugging registers. 

Available on: 80386 or higher. Restrictions: VCPI must be installed. 
Registers at call: Return Registers: 

AX = DE09h AH = 00h 


ES:DI -> array of 8 DWORDs holding new values 
of debug registers 

Details: Values for DR4 and DRS ignored. 

Conflicts: None known. 

See Also: Function DEh Subfunction 08h 


INTERRUPT 67h - Function DEh, Subfunction OAh 
GET 8259 INTERRUPT VECTOR MAPPINGS 


Purpose: Determine the interrupt numbers corresponding to the hardware interrutp request lines. 


Available on: 80386 or higher. Restrictions: VCPI must be installed. 
Registers at call: Return Registers: 
AX = DEOAh AH = 00h successful 


BX = first vector used by master 8259 (IRQO) 
CX = first vector used by slave 8259 (IRQ8) 
AH nonzero: failed 
Details: CX is undefined in systems without a slave 8259. 
Conflicts: None known. 
See Also: Function DEh Subfunction OBh 


INTERRUPT 67h - Function DEh, Subfunction 0Bh 
SET 8259 INTERRUPT VECTOR MAPPINGS 


Purpose: Specify which interrupt numbers should correspond to the hardware interrupt request lines. 


Available on: 80386 or higher. Restrictions: VCPI must be installed. ! 
Registers at call: Return Registers: : 
AX = DEOBh AH = 00h successful 

BX = first vector used by master 8259 AH nonzero: failed 


CX = first vector used by slave 8259 

interrupts disabled 

Details: This call merely informs the server that the client has changed the interrupt mappings. The client may not 
change the mappings if they have already been changed by the server or another client, and is responsible for 
restoring the original mappings before terminating. 

Conflicts: None known. 

See Also: Function DEh Subfunction 0Ah 


INTERRUPT 67h - Function DEh, Subfunction 0Ch 
SWITCH TO PROTECTED MODE 


Purpose: Begin executing in protected mode rather than Virtual-86 mode. 


Available on: 80386 or higher. Restrictions: VCPI must be installed. 
Registers at call: Return Registers: 
AX = DE0Ch interrupts disabled 
ESI = linear address in first megabyte of values for GDTR, IDTR, LDTR, TR loaded 
system registers (Table 10-7) SS:ESP must have at least 16 bytes space, and entry 
interrupts disabled point must set up new stack before enabling interrupts 


BAX, ESI, DS, ES, FS, GS destroyed 
Details: In protected mode, calling the protected-mode VCPI entry point with: 
AX = DEOCh 


DS = segment selector from function DEOIh 
SS:ESP in first megabyte of linear memory 
STACK: QWORD return address from FAR call to 32-bit segment 

DWORD EIP 

DWORD CS 

DWORD reserved for EFLAGS 

DWORD ESP 

DWORD SS 

DWORD ES 

DWORD DS 

DWORD FS 

DWORD GS 


and interrupts disabled, will switch to virtual86 mode with interrupts disabled, all segment registers loaded, 


and EAX destroyed. 


Conflicts: None known. 


See Also: INT 15h Function 89h (chapter 3) 


Table 10-7. Format of system register values for switch to protected mode: 


Offset 
00h 
04h 
08h 
0Ch 
OEh 
10h 


Size 
DWORD 
DWORD 
DWORD 
WORD 
WORD 
PWORD 


Description 

value for CR3 

linear address in first megabyte of value for GDTR. 
linear address in first megabyte of value for IDTR 
value for LDTR 

value for TR 

CS:EIP of protected mode entry-point 
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DOS Protected-Mode Interface 





DPMI is the intended successor to VCPI (Virtual Control Program Interface, see chapter 10). It allows DOS pro- 
grams to use the protected-mode features of the 80286 and later processors without compromising built-in system 


protections. 
Although not itself a DOS extender, DPMI provides all the primitives necessary to implement one. As a result, 


there are numerous cross-references from this chapter to chapter 9. 
Borland DPMI LOADER 


INTERRUPT 2Fh - Function FBh, Subfunction 42h 
Borland DPMI LOADER (DPMILOAD.EXE) 


Purpose: Load Turbo Assembler (TASM) into extended memory under DPMI. 


Available on: 80286 or higher with DPMI. Restrictions: DPMILOAD must be installed. 
Registers at call: Return Registers: 

AX = FB42h AX =0001h 

BX = 0001h unknown. ES:BX - >unknown, 


CX = unknown. 
DX = unknown. 


BX = 0002h unknown. AX = unknown. 
Call: ES,SLDI 
BX = 0003h get free memory. DX:AX = free memory 
BX = 0004h unknown. CX = unknown. 
BX = 0005h unknown. DX = unknown. 
BX = 0006h unknown. DX = unknown. 
CX = unknown. 
DX = unknown. 
BX = 0007h unknown. unknown. 
CX = unknown. 
BX = 0008h unknown. DX = unknown. 


CX = unknown. 

DX = unknown. 
else calls DPMI INT 31h Function 09h 
Subfunction 00h 
Conflicts: None known. 


DOS Protected-Mode Interface 
Note: All INT 31h calls listed in this chapter are available in protected mode only. Where a version of DPMI is refer- 


enced, the meaning is any DPMI host conforming to the stated version of the specification. 


INTERRUPT 2Fh - Function 16h, Subfunction 86h 


DETECT PROCESSOR MODE 
Purpose: Determine current operating mode of CPU under DPMI. 
Available on: All machines. Restrictions; DPMI must be installed. 
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Registers at call: Return Registers: 
AX = 1686h AX = 0000h if operating in protected mode under 
DPMI (INT 31 available) 
AX nonzero if in real/V86 mode or no DPMI 
(INT 31 not available) 
Conflicts: None known. 
See Also: Function 16h Subfunction 87h 


INTERRUPT 2Fh - Function 16h, Subfunction 87h 
DPMI INSTALLATION CHECK 


Purpose: Determine whether DPMI installed. 


Available on: All machines, Restrictions: none. 

Registers at call: Return Registers: 

AX = 1687h AX = 0000h if installed 
BX = flags 


bit 0: 32-bit programs supported 
CL = processor type 
(02h=80286, 03h=80386, 04h=80486) 
DH = DPMI major version 
DL = two-digit DPMI minor version 
SI = number of paragraphs of DOS extender 
private data 
ES:DI -> DPMI mode-switch entry point 
Details: Mode Switch routine changes from real to protected mode. 
Conflicts: None known. 
See Also: Function 16h Subfunction 86h 


Call Mode Switch entry point with: 
AX = flags 
bit 0: set if 32-bit program 
ES = real mode segment of buffer for DPMI private data (ignored if SI was zero) 
Note: This entry point is only called for the initial switch to protected mode. 


Mode Switch routine returns with: 

CF set on error, program still in real mode 

CF clear if successful, program now in protected mode, registers: 
CS = 16-bit selector corresponding to real-mode CS 
SS = selector corresponding to real-mode SS (64K limit) 
DS = selector corresponding to real-mode DS (64K limit) 
ES = selector to program's PSP (100h byte limit) 
FS =GS$ =0 
high word of ESP = 0 if 32-bit program 


INTERRUPT 2Fh - Function 16h, Subfunction 8Ah 
GET VENDOR-SPECIFIC API ENTRY POINT 


Purpose: Determine the address to call for vendor-specific extensions to the DPMI specification. 


Available on: 80286 or higher in protected mode. Restrictions; DPMI version 0.9 or higher must be 
installed. 

Registers at call: Return Registers: 

AX = 168Ah AL = status 

DS:(E)SI = selector:offset of ASCIZ vendor name 00h successful 


ES:(E)DI -> extended API entry point 
8Ah unsuccessful 
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Details: The vendor name is used to determine which entry point to return; it is case-sensitive. 32-bit applications 
use ESI and EDI, 16-bit applications use SI and DI. Although not documented until version 1.0 of the DPMI 
specification, this call is available in version 0.9 implementations. 


Conflicts: None known. 
See Also: INT 31h Function OAh Subfunction 00h 


INTERRUPT 31h - Function 00h, Subfunction 00h 


ALLOCATE LDT DESCRIPTORS 


Purpose: Allocate a specified number of contiguous descriptor's in the calling task's Local Descriptor Table. 


Available on: 80286 or higher in protected mode. 


Registers at call: 
AX = 0000h 
CX = number of descriptors to allocate 


Table 11-1. DPMI Version 1.0 Error Codes 


0000h-7FFFh DOS error passed through by DPMI 
8001h unsupported function 

8002h object in wrong state for function 
8003h system integrity would be endangered 
8004h deadlock detected 

8005h pending serialization request cancelled 
8010h out of DPMI internal resources 

801 1h descriptor unavailable 

8012h linear memory unavailable 

8013h physical memory unavailable 

8014h backing store unavailable 

8015h callback unavailable 


Details: The base and limit of the returned descriptors will be 0, and the ty; 


Restrictions: DPMI version 0.9 or higher must be 
installed. 
Return Registers: 
CF clear if successful 
AX = base selector 
CF set on error 
AX = error code (DPMI 1.0+) 


8016h handle unavailable 

8017h maximum lock count exceeded 

8018h shared memory already serialized exclusively 
by another 

8019h shared memory already serialized shared by 
another client 

8021h invalid value for numeric or flag parameter 

8022h invalid segment selector 

8023h invalid handle 

8024h invalid callback 

8025h invalid linear address 

8026h request not supported by hardware 


by INT 31h Function 00h Subfunction 03h to move to subsequent descriptors if multiple descriptors were allocated. 
This function is not supported by MS Windows 3.0 in Standard mode. 


Conflicts: None known. 
See Also: Function 00h Subfunctions 01h and ODh 


INTERRUPT 31h - Function 00h, Subfunction 01h 


FREE LDT DESCRIPTOR 


Purpose: Release a Local Descriptor Table segment descript 


Available on: 80286 or higher in protected mode. 


Registers at call: 
AX = 0001h 
BX = selector to free 


Details: Only one descriptor is freed per call. The program's initial CS, DS, and SS descriptors may be freed; any 
segment registers containing the selector will be set to zero. 


or. 
Restrictions; DPMI version 0,9 or higher must be 


installed. 
Return Registers: 
CF clear if successful 
CF set on error 
AX = error code (DPMI 1.0+) (8022h) (see 
Function 
00h Subfunction 00h) 


This function is not supported by MS Windows 3.0 in Standard mode. 


Conflicts: None known. 


See Also: Function 00h Subfunctions 00h, 0Ah, and ODh 


pe will be "data". Add the value returned 
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INTERRUPT 31h - Function 00h, Subfunction 02h 


SEGMENT TO DESCRIPTOR 

Purpose: Create an LDT descritor teferencing the specified real-mode segment. 

Available on: 80286 or higher in protected mode. Restrictions: DPMI version 0.9 or higher must be 

installed. 

Registers at call: Return Registers: 

AX = 0002h CF clear if successful 

BX = real mode segment AX = selector corresponding to real mode segment 
(64K limit) 


CF set on error 
AX = error code (DPMI 1.0+) (801 1h) (see 
Function 00h Subfunction 00h) 
Details: Multiple calls for the same real mode segment return the same selector. The returned descriptor can never be 
modified or freed. 
This function is not supported by MS Windows 3.0 in Standard mode. 
Conflicts: None known. 


INTERRUPT 3th - Function 00h, Subfunction 03h 
GET NEXT SELECTOR INCREMENT VALUE 


Purpose: Determine the numerical difference between adjacent descriptors returned by any call which can allocate 
multiple descriptors. 


Available on: 80286 or higher in protected mode. Restrictions: DPMI version 0.9 or higher must be 
installed. 

Registers at call: Return Registers: 

AX = 0003h CF clear 


AX = value to add to get next sequential selector 
Details: The increment will be a power of two. 
This function is not supported by MS Windows 3.0 in Standard mode, 
Conflicts: None known. 
See Also: Function 00h Subfunction 00h 


INTERRUPT 3th - Function 00h, Subfunction 04h 
RESERVED FOR HISTORICAL REASONS 


Purpose: This function was originally defined, but has been dropped from publicly-released versions of the 
specification. It should never be called. 

Available on: 80286 or higher in protected mode. Restrictions: DPMI must be installed. 

Registers at call: AX = 0004h Return Registers: n/a 

Conflicts: None known. 


INTERRUPT 31h - Function 00h, Subfunction 05h 
RESERVED FOR HISTORICAL REASONS 


Purpose: This function was originally defined, but has been dropped from publicly-released versions of the 
specification. It should never be called. 


Available on: 80286 or higher in protected mode, Restrictions: DPMI version 0.9 or higher must be 
installed, 
Registers at call: AX = 0005h Return Registers: n/a 


Conflicts; None known. 


INTERRUPT 31h - Function 00h, Subfunction 06h 
GET SEGMENT BASE ADDRESS 


Purpose: Determine the starting linear address of the specified LDT descriptor. 
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Available on: 80286 or higher in protected mode. Restrictions: DPMI version 0.9 or higher must be 
installed. 

Registers at call: Return Registers: 

AX = 0006h CF clear if successful 

BX = selector CX:DX = linear base address of segment 


CF set on error 
AX =error code (DPMI !.0+) (8022h) (see 
Function 00h Subfunction 00h) 
Details: This function is not supported by MS Windows 3.0 in Standard mode. 
Conflicts: None known. 
See Also: Function 00h Subfunction 07h 


INTERRUPT 31h - Function 00h, Subfunction 07h 
SET SEGMENT BASE ADDRESS 


Purpose: Specify the linear starting address for the indicated LDT descriptor. 


Available on: 80286 or higher in protected mode. Restrictions: DPMI version 0.9 or higher must be 
installed. 

Registers at call: Return Registers: 

AX = 0007h CF clear if successful 

BX = selector CF set on error 

CX:DX = linear base address AX = error code (DPMI 1.0+) (8022h, 8025h) (see 


Function 00h Subfunction 00h) 
Details: Only modify descriptors allocated with INT 31h Function 00h Subfunction 00h. Only the low 24 bits of the 
address will be used by 16-bit DPMI implementations even on a 386 or higher. DPMI 1.0+ automatically reloads any 
segment registers containing the selector being modified. 
This function is not supported by MS Windows 3.0 in Standard mode. 
Conflicts: None known, 
See Also: Function 00h Subfunctions 06h, 08h, 09h, and OCh, OS/286 INT 21h Function E9h (chapter 9) 


INTERRUPT 31h - Function 00h, Subfunction 08h 


SET SEGMENT LIMIT 

Purpose: Specify the highest offset within the segment for the indicated LDT descriptor. 

Available on: 80286 or higher in protected mode. Restrictions: DPMI version 0.9 or higher must be 
installed. 

Registers at call: Return Registers: 

AX = 0008h CF clear if successful 

BX = selector CF set on error 

CX:DX = segment limit AX = error code (DPMI [.0+) (8021h, 8022h, 


8025h) (see Function 00h Subfunction 00h) 
Details: CX must be zero for 16-bit DPMI implementations. Limits greater than 1MB must be page aligned (low 12 
bits set). Only modify descriptors allocated with INT 31h Function 00h Subfunction 00h. DPMI 1.0+ automatically 
reloads any segment registers containing the selector being modified. 
This function is not supported by MS Windows 3.0 in Standard mode. 
Conflicts: None known. 
See Also: Function 00h Subfunctions 07h, 09h, and OCh, OS/286 INT 21h Function E9h (chapter 9) 


INTERRUPT 31h - Function 00h, Subfunction 09h 
SET DESCRIPTOR ACCESS RIGHTS 


Purpose: Specify the type of segment and manner in which it may be accessed for the indicated LDT descriptor. 


Available on: 80286 or higher in protected mode. Restrictions: DPMI version 0.9 or higher must be 
installed. 
Registers at call: Return Registers: 


AX = 0009h CF clear if successful 





i 
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BX = selector CF set on error 
CL = access rights/type byte AX = error code (DPMI 1.0+) (8021h, 8022h, 
CH = 80386 extended rights/ type byte (32-bit 8025h) (see Function 00h Subfunction 00h) 


DPMI implementations only) 
Details: If the Present bit is clear, CL bits 0-3 may have any value. DPMI 1.0+ automatically reloads any segment 
registers containing the selector being modified. 
This function is not supported by MS Windows 3.0 in Standard mode. 
Conflicts: None known. 
See Also: Function 00h Subfunctions 07h, 08h, and OCh, Phar Lap INT 21h Function 25h Subfunction 14h 


INTERRUPT 31h - Function 00h, Subfunction 0Ah 
CREATE ALIAS DESCRIPTOR 


Purpose: Make a new LDT descriptor which references the same memory as the specified descriptor. 


Available on: 80286 or higher in protected mode. Restrictions: DPMI version 0.9 or higher must be 
installed. 

Registers at call: Return Registers: 

AX = 000Ah CF clear if successful 

BX = selector AX = new data selector 


CF set on error 
AX = error code (DPMI 1.0+) (801 1h, 8022h) (see 
Function 00h Subfunction 00h) 
Details: Fails if selector in BX is not a code segment or is invalid. Use INT 31h Function 00h Subfunction O1h to 
free new selector. Future changes to the original selector will not be reflected in the returned alias selector. 
This function is not supported by MS Windows 3.0 in Standard mode, 

Conflicts: None known. 
See Also: Function 00h Subfunction 01h 


INTERRUPT 31h - Function 00h, Subfunction OBh 


GET DESCRIPTOR 

Purpose: Copy the specified entry in the local descriptor table into a caller-provided buffer. 

Available on: 80286 or higher in protected mode. Restrictions: DPMI version 0.9 or higher must be 
installed, 

Registers at call: Return Registers: 

AX = 000Bh CF clear if successful 

BX = LDT selector buffer filled 

ES:(E)DI -> 8-byte buffer for copy of descriptor CF set on error 


AX = error code (DPMI 1.0+) (8022h) (see ' 
Function 00h Subfunction 00h) : 
Details: 16-bit programs use ES:DI as pointer, 32-bit must use ES:EDI. 
This function is not supported by MS Windows 3.0 in Standard mode. 
Conflicts; None known. 
See Also: Function 00h Subfunction 0Ch 


INTERRUPT 31h - Function 00h, Subfunction 0Ch 
SET DESCRIPTOR 


Purpose: Copy a caller-provided buffer into the specified entry in the local descriptor table, thus changing the 
memory referenced by that particular selector. 


Available on: 80286 or higher in protected mode. Restrictions: DPMI version 0.9 or higher must be 
installed, 
Registers at call: Return Registers: 


AX = 000Ch CF clear if successful 
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BX =LDT selector CF set on error 
ES:(E)DI -> 8-byte buffer containing descriptor AX = error code (DPMI 1.0+) (8021h, 8022h, 
8025h) (see Function 00h Subfunction 00h) 

Details: 16-bit programs use ES:DI as pointer, 32-bit must use ES:EDI. Only modify descriptors allocated with INT 
31h Function 00h Subfunction 00h, DPMI 1.0+ automatically reloads any segment registers containing the selector 
being modified. 

This function is not supported by MS Windows 3.0 in Standard mode. 
Conflicts: None known. 
See Also: Function 00h Subfunction OBh 


INTERRUPT 31h - Function 00h, Subfunction 0Dh 
ALLOCATE SPECIFIC LDT DESCRIPTOR 


Purpose: Reserve a Local Descriptor Table entry by number. 


Available on; 80286 or higher in protected mode, Restrictions: DPMI version 0.9 or higher must be 
installed, 

Registers at call: Return Registers: 

AX = 000Dh CF clear if successful 

BX = LDT selector descriptor allocated 


CF set on error 
AX = error code (DPMI 1.0+) (801 1h, 8022h) (see 
Function 00h Subfunction 00h) 
Details: Free descriptor with INT 31h Function 00h Subfunction Oth. The first 16 descriptors (04h-7Ch) are reserved 
for this function, but some may already be in use by other applications under DPMI 0.9; DPMI 1.0 guarantees 16 
descriptors per client. 
This function is not supported by MS Windows 3.0 in Standard mode. 

Conflicts: None known. 
See Also: Function 00h Subfunctions 00h and Oh 


INTERRUPT 31h - Function 00h, Subfunction 0Eh 
GET MULTIPLE DESCRIPTORS 


Purpose: Copy one or more entries from the Local Descriptor Table into a caller-provided data buffer. 


Available on: 80286 or higher in protected mode. Restrictions: DPMI version 1.0 or higher must be 
installed. 
Registers at call: Return Registers: 
AX = 000Eh CF clear if successful 
CX = number of descriptors to copy descriptors copied 
ES:(E)DI -> descriptor buffer (see Table 11-2) CF set on error 
AX = error code (8022h) (see Function 00h 
Subfunction 00h) 


CX = number of descriptors successfully copied 
Details: 16-bit programs use ES:DI as pointer, 32-bit must use ES:EDI. If the function fails, the first CX descriptors 
are valid; the remainder are not modified. 
Conflicts: None known, 
See Also: Function 00h Subfunctions OBh and OFh 


Table 11-2. Format of descriptor buffer entry (one per descriptor to get): 
Offset Size Description 


00h WORD selector (set by client) 
02h QWORD descriptor (set by host) 
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INTERRUPT 31h - Function 00h, Subfunction OFh 
SET MULTIPLE DESCRIPTORS 


Purpose: Copy one or more descriptors into the Local Descriptor Table from a caller-provided data buffer, thus 
modifying the segments corresponding to those selectors. 


Available on: 80286 or higher in protected mode. Restrictions: DPMI version 1.0 or higher must be 
installed. 

Registers at call: Return Registers: 

AX = 000Fh CF clear if successful 

CX = number of descriptors to copy descriptors copied 

BS:(E)DI -> descriptor buffer (Table 11-3) CF set on error 


AX = error code (8021h,8022h,8025h) (see 
Function 00h Subfunction 00h) 

CX = number of descriptors successfully copied 
Details: 16-bit programs use ES:DI as pointer, 32-bit must use ES:EDI. If the function fails, the first CX descriptors 
are valid; the remainder are not modified. DPMI 1.0+ automatically reloads any segment registers containing a 
selector being modified. 
Conflicts: None known, 
See Also: Function 00h Subfunctions 0Ch and OEh 


Table 11-3, Format of descriptor buffer entry (one per descriptor to set): 


Offset Size Description 
00h WORD selector 
02h QWORD _ descriptor 


INTERRUPT 31h - Function 01h, Subfunction 00h 
ALLOCATE DOS MEMORY BLOCK 


Purpose: Requests a block of real-mode memory from DOS and creates segment selectors which may be used to 
reference that block. 


Available on: 80286 or higher in protected mode. Restrictions: DPMI version 0.9 or higher must be 
installed. 

Registers at call: Return Registers: 

AX =0100h CF clear if successful 

BX = number of paragraphs to allocate AX = real mode segment of allocated block 


DX = first selector for allocated block 
CF set on error 
(DPMI 0.9) AX = DOS error code (07h, 08h) (see 
INT 21/AH=59h) 
(DPMI 1.0+) AX = DPMI error code (801 1h) (see 
Function 00h Subfunction 00h) 
BX = size (in paragraphs) of largest available 
block 
Details: Multiple contiguous selectors are allocated for blocks of more than 64K if the caller is a 16-bit program, 
Never modify or deallocate returned descriptors. 
This function is not supported by MS Windows 3.0 in Standard mode. 
Conflicts: None known. 
See Also: Function 01h Subfunction 01h, Function 05h Subfunction Olh, DOS INT 21h Function 48h (chapter 8) 


INTERRUPT 31h - Function 01h, Subfunction 01h 
FREE DOS MEMORY BLOCK 


Purpose: Returns a block of real-mode memory to DOS and frees the descriptors which were created to reference 
that block, 
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Available on: 80286 or higher in protected mode. Restrictions: DPMI version 0.9 or higher must be 


installed. 
Registers at call: Return Registers: 
AX =0101h CF set if successful 
DX = selector of block CF set on error 
AX = DOS error code (07h,09h) (see INT 
21/AH=59h) 


Details: All descriptors allocated for the block are automatically freed, DPMI 1.0+ automatically zeros any segment 


registers containing a selector freed by this function. 
This function is not supported by MS Windows 3.0 in Standard mode, 


Conflicts: None known. 
See Also: Function 01h Subfunctions 00h and 02h, Function 05h Subfunction 02h, DOS INT 21h Function 49h 


(chapter 8) 
INTERRUPT 31h - Function 01h, Subfunction 02h 
RESIZE DOS MEMORY BLOCK 


Purpose: Modifies the size of a real-mode block of memory which was previously allocated, and creates or frees 
descriptors referencing that block as needed, 


Available on: 80286 or higher in protected mode. Restrictions: DPMI version 0.9 or higher must be 
installed, 
Registers at call: Return Registers: 
AX =0102h CF clear if successful 
BX = new block size in paragraphs CF set on error 
DX = selector of block AX = DOS error code (07h,08h,09h) (see INT 
21/AH=59h) 


(DPMI 1.0+) DPMI error code (801 th,8022h) (see 
Function 00h Subfunction 00h) 
BX = maximum block size (in paragraphs) 
possible 
Details: Increasing the size of a block past a 64K boundary will fail if the next descriptor in the LDT is already in 
use. Shrinking a block past a 64K boundary will cause some selectors to be freed; DPMI 1.0+ automatically zeros 
any segment registers containing a selector freed by this function. 
This function is not supported by MS Windows 3.0 in Standard mode. 


Conflicts: None known. 
See Also: Function 01h Subfunction 00h, DOS INT 21h Function 4Ah (chapter 8) 


INTERRUPT 31h - Function 02h, Subfunction 00h 
GET REAL MODE INTERRUPT VECTOR 


Purpose: Determine which procedure currently handles the specified interrupt in real mode for the current virtual 
machine. 


Available on: 80286 or higher in protected mode. Restrictions: DPMI version 0.9 or higher must be 
installed. 
Registers at call: Return Registers: 
AX = 0200h CF clear 
BL = interrupt number CX:DX = segment:offset of real mode interrupt 
handler 


Details: The DPMI implementation is required to support all 256 vectors. 


Conflicts: None known. 
See Also: Function 02h Subfunctions 01h and 04h, Phar Lap INT 21h Function 25h Subfunction 03h (chapter 9) 


INTERRUPT 31h - Function 02h, Subfunction Oth 
SET REAL MODE INTERRUPT VECTOR 


Purpose: Specify which procedure will handle the indicated interrupt in real mode for the current virtual machine. 
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Available on: 80286 or higher in protected mode. Restrictions: DPMI version 0.9 or higher must be 
installed. 

Registers at call: Return Registers: 

AX =0201h CF clear 


BL = interrupt number 

CX:DX = segment:offset of real mode handler 

Details: All memory that may be touched by a hardware interrupt handler must be locked down with INT 31h 
Function 06h Subfunction 00h. 

Conflicts: None known. 

See Also: Function 02h Subfunctions 00h and 05h, Function 06h Subfunction 00h, Phar Lap INT 21h Function 25h 
Subfunction 05h (chapter 9) 


INTERRUPT 31h - Function 02h, Subfunction 02h 
GET PROCESSOR EXCEPTION HANDLER VECTOR 


Purpose: Determine which procedure currently handles processor exceptions. 


Available on: 80286 or higher in protected mode. Restrictions: DPMI version 0.9 or higher must be 
installed. 

Registers at call: Return Registers: 

AX = 0202h CF clear if successful 

BL = exception number (00h-1Fh) CX:(E)DX = selector:offset of handler 


CF set on error 
AX = error code (DPMI 1.0+) (8021h) (see 
Function 00h Subfunction 00h) 
Details: 16-bit programs receive the pointer in CX:DX, 32-bit programs in CX:EDX, DPMI 1.0+ supports this 
function only for backward compatibility; use Function 02h Subfunctions 10h or 11h instead. 
This function is not supported by MS Windows 3.0 in Standard mode. 
Conflicts: None known. 
See Also: Function 02h Subfunctions 03h, 10h and 11h 


INTERRUPT 31h - Function 02h, Subfunction 03h 
SET PROCESSOR EXCEPTION HANDLER VECTOR 


Purpose: Specify which procedure will handle processor exceptions, 


Available on: 80286 or higher in protected mode, Restrictions: DPMI version 0.9 or higher must be 
installed. 

Registers at call: Return Registers: 

AX = 0203h CF clear if successful 

BL = exception number (00h-1Fh) CF set on error 

CX:(E)DX = selector:offset of handler AX = error code (DPMI 1.0+) (8021h, 8022h) (see 


Function 00h Subfunction 00h) 

Details: 32-bit programs must supply an offset in EDX and use a 32-bit interrupt stack frame on chaining to the next 
exception handler. The handler should return using a FAR return. All fault stack frames contain an error code, but it 
is only valid for exceptions 08h and QAh-OEh, Handlers will only be called if the exception occurs in protected 
mode, and the DPMI host does not transparently handle the exception, The handler may change certain values on the 
stack frame (see Tables 11-4 and 11-5). DPMI 1.0+ supports this function only for backward compatibility; use 
Function 02h Subfunctions 12h or 13h instead, 

This function is not supported by MS Windows 3.0 in Standard mode. 
Conflicts: None known. 
See Also: Function 02h Subfunctions 02h, 12h, and 13h 


Table 11-4. Format of stack frame for 16-bit programs: (offset from SS:SP) 


Offset Size Description 
00h DWORD _ return CS:IP (do not change) 
04h WORD error code 


} 
i 
} 
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Table 11-4. Format of stack frame for 16-bit programs ( continued) 


Offset Size Description 

06h DWORD  CS:IP of exception 

OAh WORD flags 

0c DWORD _ SS:SP 
Table 11-5. Format of stack frame for 32-bit programs: ( offset from SS:ESP) 
Offset Size Description 

00h DWORD return EIP (do not change) 

04h WORD return CS selector (do not change) 
06h WORD reserved (do not change) 

08h DWORD _ error code 

0Ch DWORD _ EIP of exception 

10) WORD CS selector of exception 

12h WORD reserved (do not change) 

14h DWORD- EFLAGS 

18h DWORD ESP 

1Ch WORD SS 

1Eh WORD reserved (do not change) 





INTERRUPT 31h - Function 02h, Subfunction 04h 
GET PROTECTED MODE INTERRUPT VECTOR 


Purpose: Determine which procedure currently handles the specified interrupt in protected mode. 





Available on: 80286 or higher in protected mode. Restrictions: DPMI version 0.9 or higher must be 
installed, 

Registers at call: Return Registers: 

AX = 0204h CF clear 

BL = interrupt number CX:(E)DX = selector:offset of handler 


Details: 16-bit programs use CX:DX, 32-bit programs use CX:EDX. DPMI implementations are required to support 


all 256 vectors. 
This function is not supported by MS Windows 3.0 in Standard mode. 


Conflicts: None known. 
See Also: Function 02h Subfunctions 00h and 05h, Phar Lap INT 21h Function 25h Subfunction 02h (chapter 9) 


INTERRUPT 31h - Function 02h, Subfunction 05h 
SET PROTECTED MODE INTERRUPT VECTOR 


Purpose: Specify which procedure will handle the indicated interrupt in protected mode. 


Available on: 80286 or higher in protected mode. Restrictions: DPMI version 0.9 or higher must be 
installed. 

Registers at call: Return Registers: 

AX = 0205h CF clear if successful 

BL = interrupt number CF set on error 

CX:(E)DX = selector:offset of handler AX = error code (DPMI 1.0+) (8022h) (see 


Function 00h Subfunction 00h) 
Details: 16-bit programs use CX:DX, 32-bit programs use CX:EDX. 32-bit programs must use a 32-bit interrupt 
stack frame when chaining to the next handler. DPMI implementations are required to support all 256 vectors. 
Hardware interrupts are reflected to the virtual machine's primary client, software interrupts to the current client. 
This function is not supported by MS Windows 3.0 in Standard mode. 


Conflicts: None known. 
See Also: Function 02h Subfunctions 01h and 04h, Phar Lap INT 21h Function 25h Subfunction 04h (chapter 9) 
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INTERRUPT 31h - Function 02h, Subfunction 10h 
GET PROTECTED MODE EXTENDED PROCESSOR EXCEPTION HANDLER 


Purpose: Determine which procedure currently handles the specified protected mode processor exception, 


Available on: 80286 or higher in protected mode. Restrictions: DPMI version 1.0 or higher must be 
installed. 

Registers at call: Return Registers: 

AX =0210h CF clear if successful 

BL = exception number (00h-1Fh) CX:(EDX) = selector:offset of exception handler 


CF set on error 
AX = error code (8021h) (see Function 00h 
Subfunction 00h) 
Details: DPMI host reflects exception to current client's handler, 
Conflicts; None known. 
See Also: Function 02h Subfunctions 02h, 11h, and 12h 


INTERRUPT 31h - Function 02h, Subfunction 11h 
GET REALMODE EXTENDED PROCESSOR EXCEPTION HANDLER 


Purpose: Determine which protected-mode procedure currently handles the specified real-mode processor 
exception. 


Available on: 80286 or higher in protected mode. Restrictions: DPMI version 1.0 or higher must be 
installed. 

Registers at call: Return Registers: 

AX =0211h CF clear if successful 

BL = exception number (00h-1Fh) CX:(EDX) = selectorioffset of exception handler 


CF set on error 
AX = error code (8021h) (see Function 00h 
Subfunction 00h) 
Details: Returns address of protected-mode handler for real-mode exception. DPMI host performs a switch to 
protected mode, reflects the exception to the virtual machine's primary client, and returns to real mode on the 
handler's completion. 
Conflicts: None known. 
See Also: Function 02h Subfunctions 02h, 10h, and 13h 


INTERRUPT 31h - Function 02h, Subfunction 12h 
SET PROTECTED MODE EXTENDED PROCESSOR EXCEPTION HANDLER 


Purpose: Specify which procedure will handle the indicated protected mode processor exception. 


Available on: 80286 or higher in protected mode. Restrictions: DPMI version 1.0 or higher must be : 
installed. : 

Registers at call: Return Registers: 

AX = 0212h CF clear if successful 

BL = exception or fault number (0Oh-1Fh) CF set on error 

CX:(E)DX = exception handler selector:offset AX = error code (8021h,8022h) (see Function 00h 


Subfunction 00h) 
Details: DPMI host sends exception to current client's handler. 
Conflicts: None known. 
See Also: Function 02h Subfunction 03h, 10h, and 13h 


INTERRUPT 31h - Function 02h, Subfunction 13h 
SET REALMODE EXTENDED PROCESSOR EXCEPTION HANDLER 


Purpose: Specify which protected-mode procedure will handle the indicated real-mode processor exception. 
Available on: 80286 or higher in protected mode. Restrictions: DPMI version 1.0 or higher must be 
installed, 
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Registers at call: Return Registers: 
AX = 0213h CF clear if successful 
BL = exception or fault number (O0h-1Fh) CF set on error 


AX =error code (8021h, 8022h) (see Function 00h 
Subfunction 00h) 

Details: Specifies address of protected-mode handler for real-mode exception. DPMI host performs a switch to 

protected mode, reflects the exception to the virtual machine's primary client, and returns to real mode on the 

handler's completion. 

Conflicts: None known. 

See Also: Function 02h Subfunction 03h, {1h, and 12h 


INTERRUPT 31h - Function 03h, Subfunction 00h 
SIMULATE REAL MODE INTERRUPT 


Purpose: Executes a real-mode interrupt handler. 


CX:(E)DX = exception handler selector:offset 


Available on: 80286 or higher in protected mode. Restrictions; DPMI version 0.9 or higher must be 
installed, 
Registers at call: Return Registers: 
AX = 0300h CF clear if successful 
BL = interrupt number real mode call structure modified (all fields except 
BH = flags: SS:SP, CS:IP filled with return values from 
bit 0: reset the interrupt controller and A20 line real mode interrupt) 
(DPMI 0.9) 
reserved, must be 0 (DPMI 1.0+) CF set on error 
others must be 0 AX = error code (DPMI 1.0+) (8012h, 8013h, 
CX = number of words to copy from protected 8014h, 8021h) (see Function 00h Subfunction 
mode to real mode stack 00h) 
ES:(E)DI = selector:offset of real mode call protected mode stack unchanged 


structure (see Table | 1-6) 
Details: 16-bit programs use ES:DI as pointer, 32-bit programs use ES:EDL CS:IP in the real mode call structure is 
ignored for this call, instead, the indicated interrupt vector is used for the address. The flags in the call structure are 
pushed on the real mode stack to form an interrupt stack frame, and the trace and interrupt flags are clear on entry to 
the handler. DPMI will provide a small (30 words) real mode stack if SS:SP is zero. The real mode handler must 
return with the stack in the same state as it was on being called. 
Conflicts: None known, 
See Also: Function 03h Subfunction 02h, Phar Lap INT 21h Function 25h Subfunction 11h (chapter 9), OS/286 INT 
21h Function E3h (chapter 9). 


Table 11-6. Format of real mode call structure: 





Offset Size Description 
00h DWORD_ EDI 

04h DWORD ESI 

O8h DWORD- EBP 

0Ch DWORD _ reserved (00h) 
101 DWORD EBX 

14h DWORD EDX 

{8h DWORD ECX 

ICh DWORD EAX 

20h WORD flags 

22h WORD ES 

24h WORD DS 

26h WORD FS 

28h WORD GS 

2Ah WORD IP 


2Ch WORD cS 
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Table 11-6. Format of real mode call structure (continued) 


Offset Size Description 
2Eh WORD SP 
30h WORD SS 


INTERRUPT 31h - Function 03h, Subfunction 01h 
CALL REAL MODE PROCEDURE WITH FAR RETURN FRAME 


Purpose: Executes a subroutine in real mode. 


Available on: 80286 or higher in protected mode. Restrictions: DPMI version 0.9 or higher must be 
installed, 
Registers at call: Return Registers: 
AX = 030th CF clear if successful 
BH = flags real mode call structure modified (all fields except 
bit 0: reset the interrupt controller and A20 SS:SP, CS:IP filled with return values from 
line (DPMI 0.9) real mode interrupt) 
reserved, must be 0 (DPMI 1.0+) CF set on error 
others must be 0 AX = error code (DPMI 1.0+) (8012h, 8013h, 
CX = number of words to copy from protected 8014h, 8021h) (see Function 00h Subfunction 
mode to real mode stack 00h) 
ES:DI/ES:EDI = selector:offset of real mode call protected mode stack unchanged 
structure (see INT 31h Function 03h 
Subfunction 00h) 


Details: 16-bit programs use ES:DI as pointer, 32-bit programs use ES:EDI. The real mode procedure must exit with 
a FAR return. DPMI will provide a small (30 words) real mode stack if SS:SP is zero. The real mode handler must 
return with the stack in the same state as it was on being called. 

Conflicts: None known. 

See Also: Function 03h Subfunctions 00h and 02h, Phar Lap INT 21h Function 25h Subfunction Oh (chapter 9), 
OS/286 INT 21h Function E3h (chapter 9) 


INTERRUPT 31h - Function 03h, Subfunction 02h 
CALL REAL MODE PROCEDURE WITH IRET FRAME 


Purpose: Executes a subroutine in real mode. 


Available on: 80286 or higher in protected mode. Restrictions: DPMI version 0.9 or higher must be 
installed. 

Registers at call: Return Registers: 

AX = 0302h CF clear if successful 

BH = flags real mode call structure modified (all fields except 
bit 0: reset the interrupt controller and A20 line SS:SP, CS:IP filled with return values from 

(DPMI 0.9) real mode interrupt) 
reserved, must be 0 (DPMI 1.0+) CF set on error 

others must be 0 AX = error code (DPMI 1.0+) (8012h, 8013h, 

CX = number of words to copy from protected 8014h, 8021h) (see Function 00h Subfunction 
mode to real mode stack 00h) 

ES:DI/ES:EDI = selector:offset of real mode call protected mode stack unchanged 


structure (see INT 31h Function 03h 

Subfunction 00h) 
Details: 16-bit programs use ES:DI as pointer, 32-bit programs use ES:EDI. The flags in the call structure are 
pushed on the real mode stack to form an interrupt stack frame, and the trace and interrupt flags are clear on entry to 
the handler. The real mode procedure must exit with an IRET. DPMI will provide a small (30 words) real mode stack 
if SS:SP is zero; the real mode handler must return with the stack in the same state as it was on being called. 
Conflicts: None known. 
See Also: Function 03h Subfunction 00h 
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INTERRUPT 31h - Function 03h, Subfunction 03h 
ALLOCATE REAL MODE CALLBACK ADDRESS 


Purpose: Reserve a unique real mode address which may be called to transfer control from a real-mode procedure or 
interrupt handler to a protected-mode subroutine. 


Available on: 80286 or higher in protected mode. Restrictions: DPMI version 0.9 or higher must be 
installed, 
Registers at call: Return Registers: 
AX = 0303h CF clear if successful 
DS:SI/DS:ESI = selector:offset of procedure to call CX:DX = segmentioffset of real mode call address 
ES:DI/ES:EDI = selector:offset of real mode call CF set on error 
structure (see Function 03h Subfunction 00h) AX = error code (DPMI 1.0+) (8015h) (see 


Function 00h Subfunction 00h) 
Details: The real mode call structure is static, causing reentrancy problems; its contents are only valid at the time of 
acallback. The called procedure must modify the real mode CS:IP before returning. Values are returned to real mode 
by modifying the real mode call structure. DPMI hosts must provide at least 16 callbacks per client. 


Conflicts; None known. 
See Also: Function 03h Subfunction 04h, Function 0Ch Subfunction 00h 


Table 11-7, Values callback procedure called with: 
DS:SI / DS:ESI = selector:offset of real mode SS:SP 
ES:DI / BS:EDI = selector:offset of real mode call structure 
SS:SP / SS:ESP = locked protected mode API stack 
interrupts disabled 
Returns (with JRET): 
ES:DI / ES:EDI = selector:offset of real mode call structure to restore 


INTERRUPT 31h - Function 03h, Subfunction 04h 
FREE REAL MODE CALLBACK ADDRESS 


Purpose: Release a previously reserved callback. 


Available on: 80286 or higher in protected mode. Restrictions: DPMI version 0.9 or higher must be 
installed. 

Registers at call: Return Registers: 

AX = 0304h CF clear if successful 

CX:DX = real mode callback address CF set on error 


AX = error code (DPMI 1.0+) (8024h) (see 
Function 00h Subfunction 00h) 


Conflicts: None known. 
See Also: Function 03h Subfunction 03h 


INTERRUPT 31h - Function 03h, Subfunction 05h 
GET STATE SAVE/RESTORE ADDRESSES 


Purpose: Determine which procedures to call for saving and restoring the current task's registers in the currently 
inactive processor mode. 


Available on: 80286 or higher in protected mode. Restrictions: DPMI version 0.9 or higher must be 
installed. 

Registers at call: Return Registers: 

AX = 0305h CF clear 


AX = size in bytes of state buffer 
BX:CX = real mode address of procedure to 
save/restore state 
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SIDI / SIEDI = protected mode procedure to 
save/restore state 
Details: The buffer size will be zero if it is not necessary to preserve state. 16-bit programs should call SI:DI, 32-bit 
programs should call SI:EDI. This function is only needed if using the raw mode switch service. 
Conflicts: None known. 
See Also: Function 03h Subfunction 06h 


Table 11-8. Values to call state-save procedures with: 
AL = direction 
00h save state 
Oth restore state 
ES:DI / ES:EDI -> state buffer 
Returns all registers preserved. 


INTERRUPT 31h - Function 03h, Subfunction 06h 


GET RAW MODE SWITCH ADDRESSES 


Purpose: Determine low-level procedures which may be used to switch from protected to real mode and real mode 
to protected mode, 


Available on: 80286 or higher in protected mode. Restrictions: DPMI version 0.9 or higher must be 
installed. 

Registers at call: Return Registers: 

AX = 0306h CF clear 


BX:CX -> procedure to switch from real to 
protected mode 
SI:DI / SI:EDI -> procedure to switch from 
protected to real mode 
Details: 16-bit programs should jump to SI:DI, 32-bit programs should use SI:EDI. The caller must save and restore 
the state of the task with Function 03h Subfunction 05h. 
This function is not supported by MS Windows 3.0 in Standard mode. 
Conflicts: None known. 
See Also: Function 03h Subfunction 05h 


Table 11-9. Values to JUMP at mode-switch procedures with: 

AX = new DS 

CX = new ES 

DX = new SS 

BX/EBX = new SP/ESP 

SI = new CS 

DI/EDI = new IP/EIP 

BP/EBP is preserved across the call, but AX/EAX, BX/EBX, CX/ECX, DX/EDX, SI/ESI, and DI/EDI will be 

undefined; FS and GS will be 0000h. Interrupts will stay disabled during the entire mode switch if they are disabled 
on entry to the mode-switch procedure. 


INTERRUPT 31h - Function 04h, Subfunction 00h 


GET DPMI VERSION 

Purpose: Determine the version of the DPMI specification supported by the host and which options are available. 

Available on: 80286 or higher in protected mode. Restrictions: DPMI version 0.9 or higher must be 
installed. 

Registers at call: AX = 0400h Return Registers: 


CF clear 
AH = major version of DPMI spec supported 
AL = two-digit minor version of DPMI spec 
supported 
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Conflicts: None known, 
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BX = flags 
bit 0: running under an 80386 (32-bit) 
implementation 
bit 1: processor returns to real mode for 
reflected interrupts instead of V86 mode 
bit 2: virtual memory supported 
bit 3: reserved (undefined) 
others reserved (zero) 
CL = processor type (02h = 80286, 03h = 80386, 
04h = 80486) 
DH = curr value of virtual master interrupt 
controller base interrupt 
DL = curr value of virtual slave interrupt controller 
base interrupt 


See Also: Function 04h Subfunction 01h, Phar Lap INT 21h Function 25h Subfunction 0Ch (chapter 9) 


INTERRUPT 31h - Function 04h, Subfunction 01h 
GET DPMI CAPABILITIES 


Purpose: Determine the capabilities supported by the installed DPMI host. 


Available on: 80286 or higher in protected mode. 


Registers at call: 

AX = 0401h 

ES:(E)DI -> 128-byte host version buffer 
(see Table 11-10) 


Conflicts: None known. 
See Also: Function 04h Subfunction 00h 


Table 11-10. Format of host version buffer: 


Offset Size Description 
00h BYTE host major version number 
Oth BYTE host minor version number 


02h 126 Bytes ASCIZ host vendor name 


INTERRUPT 31h - Function 05h, Subfunction 00h 
GET FREE MEMORY INFORMATION 


Purpose: Determine total and available memory amounts. 


Restrictions: DPMI version 1.0 or higher must be 
installed, 
Return Registers: 
CF clear if successful 
AX = capabilities 
bit 0: page accessed/dirty supported (see 
Function 05h Subfunctions 06h or 07h) 
1: exceptions restartability supported 
2: device mapping supported (see Function 05h 
Subfunction 08h) 
3: conventional memory mapping supported 
(see Function 05h Subfunction 09h) 
4; demand zero-fill supported 
5; write-protect client capability supported 
6: write-protect host capability supported 
7-15: reserved 
CX = reserved (00h) 
DX = reserved (00h) 
buffer filled 
CF set on error (DPMI 0.9 only) 
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Available on: 80286 or higher in protected mode. Restrictions: DPMI version 0.9 or higher must be 
installed. 

Registers at call: Return Registers: 

AX = 0500h CF clear 


ES:DI/ BS:EDI -> buffer for memory information 

(see Table 11-11) 
Details: 16-bit programs use ES:DI, 32-bit programs use ES:EDI. This function must be considered advisory 
because other applications may affect the results at any time after the call. Fields not supported by the DPMI 
implementation are filled with FFFFFFFFh. DPMI 1.0+ supports this function solely for backward compatibility; use 
Function 05h Subfunction OBh instead. 
Conflicts: None known. 
See Also: Function 05h Subfunction 01h, Function 06h Subfunction 04h 


Table 11-11, Format of memory information: 





Offset Size Description 

00h DWORD largest available block in bytes 

04h DWORD maximum unlocked page allocation 

08h DWORD maximum locked page allocation 

0Ch DWORD total linear address space in pages 

10h DWORD total unlocked pages 

14h DWORD free pages 

18h DWORD _ total physical pages 

1Ch DWORD _ free linear address space in pages 

20h DWORD _ size of paging file/partition in pages 

24h 2 Bytes reserved 

INTERRUPT 31h - Function 05h, Subfunction Oth 

ALLOCATE MEMORY BLOCK 

Purpose: Request a block of committed (physical or virtual with backing store) memory, 

Available on: 80286 or higher in protected mode. Restrictions: DPMI version 0.9 or higher must be 
installed, 

Registers at call: Return Registers: 

AX = 0501h CF clear if successful 

BX:CX = size in bytes BX:CX = linear address of block 


SI:DI = memory block handle for resizing and 
freeing block 
CF set on error 
AX = error code (DPMI 1.0+) (8012h-8014h, 
8016h, 8021h) (see Function 00h Subfunction 
00h) 
Details: No selectors are allocated. The memory block is allocated unlocked (can be locked with Function 06h 
Subfunction 00h). Allocations are often page granular (see Function 06h Subfunction 04h), 
Conflicts: None known. 
See Also: Function 00h Subfunction 00h, Function 01h Subfunction 00h, Function 05h Subfunctions 00h and 02h- 
04h, Function ODh Subfunction 00h 


INTERRUPT 31h - Function 05h, Subfunction 02h 
FREE MEMORY BLOCK 


Purpose: Release a previously allocated block of memory. 


Available on: 80286 or higher in protected mode. Restrictions: DPMI version 0.9 or higher must be 
installed, 
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Registers at call: Return Registers: 
AX = 0502h CF clear if successful 
SI:DI = handle of memory block CF set on error 


AX = error code (DPMI 1.0+) (8023h) (see 
Function 00h Subfunction 00h) 
Details: Any selectors allocated for the memory block must also be freed, preferably before freeing the memory 
block. 
Conflicts: None known. 
See Also: Function 00h Subfunction 01h, Function 01h Subfunction Oth, Function 05h Subfunction 01h, Function 
ODh Subfunction 01h 


INTERRUPT 31h - Function 05h, Subfunction 03h 


RESIZE MEMORY BLOCK 

Purpose: Change the size of a previously allocated block of memory. 

Available on: 80286 or higher in protected mode. Restrictions: DPMI version 0.9 or higher must be 
installed. 

Registers at call: Return Registers: 

AX = 0503h CF clear if successful 

BX:CX = new size in bytes (nonzero) BX:CX = new linear address 

SI:DI = handle of memory block SI:DI = new handle of memory block 


CF set on error 
AX = error code (DPMI 1.0+) (8012h-8014h, 
8016h, 8021h, 8023h) (see Function 00h 
Subfunction 00h) 
Details: Any selectors pointing at the block must be updated. The previous memory block handle becomes invalid. 
An error is returned if the new size is 0. 
Conflicts: None known. 
See Also: Function 01h Subfunction 02h, Function 05h Subfunctions O1h and 05h 


INTERRUPT 31h - Function 05h, Subfunction 04h 
ALLOGATE LINEAR MEMORY BLOCK 


Purpose: Reserve a page-aligned block of the linear address space, 


Available on: 80386 or higher in protected mode. Restrictions: DPMI version 1.0 or higher must be 
installed. 
Registers at call: Return Registers: 
AX = 0504h CF clear if successful 
EBX = page-aligned linear address of memory EBX = linear address of memory block 
block (00000000h if any address is acceptable) ESI = memory block handle 
ECX = size in bytes (nonzero) CF set on error 
EDX = flags AX = error code (8001h, 8012h-8014h, 8016h, 
bit 0: set to create committed pages instead of 8021h, 8025h) (see Function 00h Subfunction 


uncommitted pages 00h) 
bits 1-31: reserved (0) 
Details: Only supported by 32-bit DPMI hosts, but may be used by 16-bit clients. 
Conflicts: None known. 
See Also: Function 05h Subfunctions 01h and 05h 


INTERRUPT 31h - Function 05h, Subfunction 05h 

RESIZE LINEAR MEMORY BLOCK 

Purpose: Modify the size of a previously allocated page-aligned block of linear address space. 

Available on: 80386 or higher in protected mode. Restrictions: DPMI version 1.0 or higher must be 
installed. 





11-20 DOS Protected-Mode Interface 


Registers at call: Return Registers: 
AX = 0505h CF clear if successful 
ESI = memory block handle EBX = new linear base address 
ECX = new size in bytes (nonzero) ESI = new memory block handle 
EDX = flags CF set on error 
bit 0: create committed pages rather than AX = error code (8001h, 8012h-8014h, 8016h, 
uncommitted pages 8021h, 8023h) (see Function 00h Subfunction 
bit 1: segment descriptor update required 00h) 
ES:EBX -> buffer containing array of 
WORDs with selectors 


EDI = number of selectors in array 
bits 2-31: reserved (0) 
Details: Only supported by 32-bit DPMI hosts, but may be used by 16-bit clients. The old memory block handle 
becomes invalid. If EDX bit 1 set and the block's base address is changed, DPMI updates all descriptors for selectors 
in the update buffer which fall within the memory block. 
Conflicts: None known. 
See Also: Function 05h Subfunctions 03h and 04h 


INTERRUPT 31h - Function 05h, Subfunction 06h 
GET PAGE ATTRIBUTES 


Purpose: Determine the type and status of one or more pages of memory within a previously allocated block of 
memory. 


Available on: 80386 or higher in protected mode. Restrictions: DPMI version 1.0 or higher must be 
installed, 

Registers at call: Return Registers: 

AX = 0506h CF clear if successful 

ESI = memory block handle buffer filled 

EBX = offset in memory block of first page CF set on error 

ECX = number of pages AX = error code (8001h, 8023h, 8025h) (see 

ES:EDX -> array of WORDs to hold page attributes Function 00h Subfunction 00h) 


(see Table 11-12) 
Details: Only supported by 32-bit DPMI hosts, but may be used by 16-bit clients. If EBX is not page-aligned, it will 
be rounded down, 
Conflicts: None known. 
See Also: Function 05h Subfunctions 04h and 07h, Phar Lap INT 21h Function 25h Subfunction 1Dh (chapter 9), 
OS/386 INT 21h Function EBh Subfunction 00h (chapter 9) 


Table 11-12. Format of page attribute words: 


Bits Meaning 
0-2 page type 
000 uncommitted 
001 committed 
010 mapped (see Function 05h Subfunctions 08h or 09h) 
other currently unused 
3 page is read/write rather than read-only 
4 accessed/dirty bits supplied in bits 5 and 6 
6) page has been accessed (only valid if bit 4 set) 
6 page has been written (only valid if bit 4 set) 
7-15 reserved (0) 
INTERRUPT 31h - Function 05h, Subfunction 07h 
MODIFY PAGE ATTRIBUTES 


Purpose: Specify the type and status of one or more memory pages within a previously allocated block of memory. 
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Available on: 80386 or higher in protected mode. Restrictions: DPMI version 1.0 or higher must be 
installed. 
Registers at call: Return Registers: 
AX =0507h CF clear if successful 
ESI = memory block handle CF set on error 
EBX = offset in memory block of first page AX = error code (800Ih, 8002h, 8013h, 8014h, 
ECX = number of pages 8021h, 8023h, 8025h) (see Function 00h 
ES:EDX -> array of WORDs with new page Subfunction 00h) 
attributes (see Function 05h Subfunction 06h) ECX = number of pages which have been set 


Details: Only supported by 32-bit DPMI hosts, but may be used by 16-bit clients. If EBX is not page-aligned, it will 
be rounded down. 

Conflicts: None known. 

See Also: Function 05h Subfunctions 04h and 06h, Phar Lap INT 21h Function 25h Subfunction 1Eh (chapter 9) 


INTERRUPT 31h - Function 05h, Subfunction 08h 
MAP DEVICE IN MEMORY BLOCK 


Purpose: Make a memory-mapped physical device visible in the specified previously-allocated block of memory. 


Available on: 80386 or higher in protected mode, Restrictions: DPMI version 1.0 or higher must be 
installed, 
Registers at call: Return Registers: 
AX = 0508h CF clear if successful 
ESI = memory block handle CF set on error 
EBX = page-aligned offset within memory block of AX = error code (800Ih, 8003h, 8023h, 8025h) 
page(s) to be mapped (see Function 00h Subfunction 00h) 


ECX = number of pages to map 

EDX = page-aligned physical address of device 

Details: Only supported by 32-bit DPMI hosts, but may be used by 16-bit clients, Support of this function is 
optional; hosts are also allowed to support the function for some devices but not others, 

Conflicts: None known. 

See Also: Function 05h Subfunctions 04h and 09h, Function 08h Subfunctions 00h and Oh 


INTERRUPT 31h - Function 05h, Subfunction 09h 


MAP CONVENTIONAL MEMORY IN MEMORY BLOCK 


Purpose: Make a portion of the one megabyte real-mode address space visible in the specified previously-allocated 
block of memory. 


Available on: 80386 or higher in protected mode. Restrictions: DPMI version 1.0 or higher must be 
installed. 
Registers at call: Return Registers: 
AX = 0509h CF clear if successful 
ESI = memory block handle CF set on error 
EBX = page-aligned offset within memory block of AX =error code (8001h, 8003h, 8023h, 8025h) 
page(s) to map (see Function 00h Subfunction 00h) 


ECX = number of pages to map 
EDX = page-aligned linear address of conventional 
(below 1M) memory 
Details: Only supported by 32-bit DPMI hosts, but may be used by 16-bit clients. Support of this function is 
optional. 
Conflicts: None known, 
See Also: Function 05h Subfunctions 04h and 08h, Function 08h Subfunction O1h 


INTERRUPT 31h - Function 05h, Subfunction OAh 
GET MEMORY BLOCK SIZE AND BASE 


Purpose: Determine the size and physical address of a previously allocated block of memory. 
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Available on: 80286 or higher in protected mode. Restrictions: DPMI version 1.0 or higher must be 
installed. 

Registers at call: Return Registers: 

AX = 050AH CF clear if successful 

SI:DI = memory block handle SIDI = size in bytes 


BX:CX = base address 
CF set on error 
AX = error code (8023h) (see Function 00h 


Subfunction 00h) 
Conflicts: None known. 
See Also: Function 05h Subfunctions 01h and 04h 
INTERRUPT 31h - Function 05h, Subfunction 0Bh 
GET MEMORY INFORMATION 
Purpose: Determine the available physical and virtual memory. 
Available on: 80286 or higher in protected mode. Restrictions: DPMI version 1.0 or higher must be 
installed. 
Registers at call: Return Registers: 
AX = 050Bh CF clear if successful 
ES:(E)DI -> 128-byte buffer for memory CF set on error (DPMI 0.9 only) 


information (see below) 
Details: 16-bit programs use ES:DI, 32-bit programs must use ES:EDI. 
Conflicts: None known. 
See Also: Function 05h Subfunction 00h 


Table 11-13. Format of memory information: 


Offset Size Description 

00h DWORD _ total allocated bytes of physical memory controlled by host 
04h DWORD _ total allocated bytes of virtual memory controlled by host 
08h DWORD _ total available bytes of virtual memory controlled by host 
0Ch DWORD _ total allocated bytes of virtual memory for curr virtual mach 
10h DWORD _ total available bytes of virtual memory for curr virtual mach 
14h DWORD _ total allocated bytes of virtual memory for current client 
18h DWORD total available bytes of virtual memory for current client 
1Ch DWORD _ total locked bytes for current client 

20h DWORD maximum locked bytes for current client 

24h DWORD _ highest linear address available to current client 

28h DWORD largest available memory block in bytes 

2Ch DWORD minimum allocation unit in bytes 

30h DWORD _ allocation alignment unit size in bytes 

34h 76 BYTEs reserved (00h) 

INTERRUPT 31h - Function 06h, Subfunction 00h 

LOCK LINEAR REGION 


Purpose: Prevent a specified portion of the program's address space from being paged out if memory demands 

exceed the total physical memory. 

Available on: 80386 or higher in protected mode. Restrictions: DPMI version 0.9 or higher must be 
installed, 
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Registers at call: Return Registers: 

AX = 0600h CF clear if successful 

BX:CX = starting linear address CF set on error 

SI:DI = size of region in bytes none of the memory is locked 


AX =error code (DPMI 1,0+) (8013h, 8017h, 
8025h) (see Function 00h Subfunction 00h) 
Details: Pages at beginning and end will be locked if the region overlaps them. May be called multiple times for a 
given page; the DPMI host keeps a lock count for each page. 


Conflicts: None known. 
See Also: Function 06h Subfunction 01h, Phar Lap INT 21h Function 25h Subfunction 1 Ah (chapter 9), OS/386 INT 


21h Function EBh Subfunction 06h (chapter 9) 


INTERRUPT 31h - Function 06h, Subfunction 01h 
UNLOCK LINEAR REGION 


Purpose: Permit a specified portion of the program's address space to be paged out if memory demands exceed the 
total physical memory. 


Available on: 80386 or higher in protected mode. Restrictions; DPMI version 0.9 or higher must be 
installed. 

Registers at call: Return Registers: 

AX = 0601h CF clear if successful 

BX:CX = starting linear address CF set on error 

SI:DI = size of region in bytes none of the memory is unlocked 


AX = error code (DPMI 1.0-+) (8002h, 8025h) (see 
Function 00h Subfunction 00h) 
Details: Pages at beginning and end will be unlocked if the region overlaps them, Any memory whose lock count 
has not reached zero remains locked. 


Conflicts: None known. 
See Also: Function 06h Subfunction 00h, Phar Lap INT 21h Function 25h Subfunction {Bh (chapter 9), OS/386 INT 


21h Function EBh Subfunction 07h (chapter 9) 


INTERRUPT 31h - Function 06h, Subfunction 02h 
MARK REAL MODE REGION AS PAGEABLE 


Purpose: Prevent a specified portion of the real-mode one megabyte address space from being paged out if memory 
demands exceed the total physical memory. 


Available on: 80386 or higher in protected mode. Restrictions: DPMI version 0.9 or higher must be 
installed. 

Registers at call: Return Registers: 

AX = 0602h CF clear if successful 

BX:CX = starting linear address CF set on error 

SI:DI = size of region in bytes none of the memory is made pageable 


AX = error code (DPMI 1.0+) (8002h, 8025h) (see 
Function 00h Subfunction 00h) 
Details: Must relock all unlocked real mode memory before terminating process for DPMI 0.9; DPMI 1.0+ 
automatically relocks real mode memory. Pages at beginning and end will be unlocked if the region overlaps them. 
Pageability of real mode pages is binary, not a count. 
Conflicts: None known. 
See Also: Function 06h Subfunctions 00h and 03h 


INTERRUPT 31h - Function 06h, Subfunction 03h 
RELOCK REAL MODE REGION 


Purpose: Permit a specified portion of the real-mode one megabyte to be paged out if memory demands exceed the 
total physical memory. 
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Available on: 80386 or higher in protected mode. Restrictions: DPMI version 0.9 or higher must be 
installed. 

Registers at call: Return Registers: 

AX = 0603h CF clear if successful 

BX:CX = starting linear address CF set on error 

SIDI = size of region in bytes none of the memory is relocked 


AX = error code (DPMI 1.0+) (8002h, 8013h, 
8025h) (see Function 00h Subfunction 00h) 
Details: Pages at beginning and end will be relocked if the region overlaps them. Pageability of real mode pages is 
binary, not a count. 
Conflicts: None known. 
See Also: Function 06h Subfunction 02h 


INTERRUPT 31h - Function 06h, Subfunction 04h 


GET PAGE SIZE 

Purpose: Determine the size of a single page of memory. 

Available on: 80386 or higher in protected mode. Restrictions: DPMI version 0.9 or higher must be 
installed. 

Registers at call: Return Registers: 

AX = 0604h CF clear if successful 


BX:CX = page size in bytes 
CF set on error 
AX = error code (DPMI 1.0+) 
8001h unsupported, 16-bit host 
Conflicts: None known. 


INTERRUPT 31h - Function 07h, Subfunction 00h 
RESERVED FOR HISTORICAL REASONS 


Purpose: This function was originally defined, but has been dropped from publicly-released versions of the 
specification; it should never be called. 


Available on: 80286 or higher in protected mode. Restrictions: DPMI must be installed. 
Registers at call: Return Registers: n/a 
AX = 0700h 


Conflicts: None known. 
INTERRUPT 31h - Function 07h, Subfunction 01h 
RESERVED FOR HISTORICAL REASONS 


Purpose: This function was originally defined, but has been dropped from publicly-released versions of the 
specification; it should never be called. 


Available on: 80286 or higher in protected mode. Restrictions: DPMI must be installed. 
Registers at call: Return Registers: n/a 
AX =0701h 


Conflicts: None known. 


INTERRUPT 31h - Function 07h, Subfunction 02h 
MARK PAGE AS DEMAND PAGING CANDIDATE 


Purpose: Indicate that the specified page or pages should be among the first to be paged out if memory demands 
exceed the total physical memory. This function may be used to improve system performance when the pages will 
not be accessed for a long period of time. 


Available on: 80386 or higher in protected mode. Restrictions; DPMI version 0.9 or higher must be 
installed, 
Registers at call: Return Registers: 


AX = 0702h CF clear if successful 


\ 
| 
| 
} 
| 





DOS Protected-Mode Interface 11-25 


BX:CX = starting linear address CF set on error 

SIDI = number of bytes to mark as paging AX = error code (DPMI 1.0+) (8025h) (see 
candidates Function 00h Subfunction 00h) 

Details: This function is advisory, and does not force immediate paging. Partial pages will not be discarded. 

Conflicts: None known. 

See Also: Function 07h Subfunction 03h 


INTERRUPT 31h - Function 07h, Subfunction 03h 
DISCARD PAGE CONTENTS 


Purpose: Indicate that the contents of a region of memory are no longer needed and may be discarded rather than 
written to disk. 


Available on: 80386 or higher in protected mode. Restrictions: DPMI version 0.9 or higher must be 
installed. 

Registers at call: Return Registers: 

AX =0703h CF clear if successful 

BX:CX = starting linear address CF set on error 


AX = error code (DPMI 1.0+) (8025h) (see 
Function 00h Subfunction 00h) 

Details: This function is advisory, and may be ignored by DPMI implementations. Partial or locked pages will not be 

discarded, 

Conflicts: None known, 

See Also: Function 07h Subfunction 02h 


INTERRUPT 31h - Function 08h, Subfunction 00h 


PHYSICAL ADDRESS MAPPING 


Purpose: Make a physical address above the one-megabyte real-mode address space visible within the caller's linear 
address space. 


SI:DI = number of bytes to mark as discarded 


Available on: 80286 or higher in protected mode. Restrictions: DPMI version 0.9 or higher must be 
installed. 

Registers at call: Return Registers: 

AX = 0800h CF clear if successful 

BX:CX = physical address (should be above 1 MB) BX:CX = linear address which maps the requested 

SI:DI = size in bytes physical memory 


CF set on error 
AX = error code (DPMI 1.0+) (8003h, 8021h) (see 
Function 00h Subfunction 00h) 

Details: Implementations may refuse this call because it can circumvent protects, The caller must build an 
appropriate selector for the memory. Do not use for memory mapped in the first megabyte. 
Conflicts: None known. 
See Also: Function 00h Subfunction 02h, Function 05h Subfunctions 08h and 09h, Function 08h Subfunction Oth, 
Phar Lap INT 21h Function 25h Subfunction OAh (chapter 9), OS/386 INT 21h Function EBh Subfunction 05h 
(chapter 9) 


INTERRUPT 31h ~ Function 08h, Subfunction 01h 
FREE PHYSICAL ADDRESS MAPPING 


Purpose: Release a previously-created mapping from a physical address to the caller's linear address space. 


Available on: 80286 or higher in protected mode, Restrictions: DPMI version 1.0 or higher must be 
installed. 
Registers at call: Return Registers: 
AX = 080th CF clear if successful 
BX:CX = linear address returned by Function 08h CF set on error 
Subfunction 00h AX = error code (8025h) (see Function 00h 


Subfunction 00h) 
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Details: Should be called at end of access to device mapped with Function 08h Subfunction 00h. 

Conflicts: None known. 

See Also: Function 05h Subfunctions 08h and 09h, Function 08h Subfunction 00h, OS/386 INT 21h Function EBh 
Subfunction 03h (chapter 9) 


INTERRUPT 31h - Function 09h, Subfunction 00h 
GET AND DISABLE VIRTUAL INTERRUPT STATE 


Purpose: Determine the current state of the virtual interrupt flag and clear it. 


Available on: 80286 or higher in protected mode, Restrictions: DPMI version 0.9 or higher must be 
installed, 

Registers at call: Return Registers: 

AX = 0900h CF ciear 


virtual interrupts disabled 
AL = 00h if previously disabled 
= Oih if previously enabled 

AH preserved 
Details: The previous state may be restored simply by executing another INT 31. A CLI instruction may be used if 
the previous state is unimportant, but should be assumed to be very slow due to trapping by the host, 
Conflicts: None known. 
See Also: Function 09h Subfunctions 01h and 02h 


INTERRUPT 31h - Function 09h, Subfunction 01h 
GET AND ENABLE VIRTUAL INTERRUPT STATE 


Purpose: Determine the current state of the virtual interrupt flag and set it. 


Available on: 80286 or higher in protected mode. Restrictions: DPMI version 0.9 or higher must be 
installed. 

Registers at call: Return Registers: 

AX =090Ih CF clear 


virtual interrupts enabled 
AL = 00h if previously disabled 
= Olh if previously enabled 

AH preserved 
Details: The previous state may be restored simply by executing another INT 31, A STI instruction may be used if 
the previous state is unimportant, but should be assumed to be very slow due to trapping by the host. 
Conflicts: None known. 
See Also: Function 09h Subfunctions 00h and 02h 


INTERRUPT 31h - Function 09h, Subfunction 02h 
GET VIRTUAL INTERRUPT STATE 


Purpose: Determine the current state of the virtual interrupt flag. 


Available on: 80286 or higher in protected mode. Restrictions: DPMI version 0.9 or higher must be 
installed. 
Registers at call: Return Registers: 
AX = 0902h CF clear 
AL = 00h if disabled 
= O1h if enabled 


Details: Should be used rather than PUSHF because that instruction yields the physical interrupt state rather than the 
per-client virtualized interrupt flag. 

Conflicts: None known. 

See Also: Function 09h Subfunctions 00h and Oth 


| 
i 
| 
| 
| 
H 
| 





DOS Protected-Mode Interface 11-27 


INTERRUPT 31h - Function 0Ah, Subfunction 00h 
GET VENDOR SPECIFIC API ENTRY POINT 


Purpose: Determine the address to call for vendor-specific extensions to the DPMI specification. 


Available on: 80286 or higher in protected mode. Restrictions: DPMI version 0.9 or higher must be 
installed. 
Registers at call: Return Registers: 
AX = 0A00h CF clear if successful 
DS:SI/DS:ESI -> case-sensitive ASCIZ vendor ES:DI/ES:EDI -> FAR extended API entry point 
name or identifier DS, FS, GS, EAX, EBX, ECX, EDX, ESI, EBP 
destroyed 


CF set on error 
AX = error code (DPMI 1.0-+) (8001h) (see 
Function 00h Subfunction 00h) 
Details: Extended API parameters are vendor-specific. DPMI 1.0+ supports this function solely for backward 
compatibility; use INT 2Fh Function 16h Subfunction 8Ah instead. 
Conflicts: None known. 
See Also: INT 2Fh Function 16h Subfunction 8Ah 


INTERRUPT 31h - Function OBh, Subfunction 00h 


SET DEBUG WATCHPOINT 

Purpose: Set a breakpoint at the specified linear address. 

Available on: 80286 or higher in protected mode. Restrictions: DPMI version 0.9 or higher must be 
installed. 

Registers at call: Return Registers: 

AX = 0B00h CF clear if successful 

BX:CX = linear address BX = watchpoint handle 

DL = size (1,2,4 bytes) CF set on error 

DH = type (00h execute, OLh write, 02h read/write) AX = error code (DPMI 1.0+) (8016h, 8021h, 


8025h) (see Function 00h Subfunction 00h) 


Conflicts: None known. 
See Also: Function 02h Subfunction 12h, Function 06h Subfunction 01h 


INTERRUPT 31h - Function OBh, Subfunction 01h 


CLEAR DEBUG WATCHPOINT 

Purpose: Remove a previously set debugging breakpoint. 

Available on: 80286 or higher in protected mode. Restrictions: DPMI version 0.9 or higher must be 
installed. 

Registers at call: Return Registers: 

AX = OBOLh CF clear if successful 

BX = watchpoint handle CF set on error 


AX = error code (DPMI 1.0-+) (8023h) (see 
Function 00h Subfunction 00h) 

Details: The watchpoint handle is freed. 

Conflicts: None known. 

See Also: Function OBh Subfunction 00h 


INTERRUPT 31h - Function 0Bh, Subfunction 02h 
GET STATE OF DEBUG WATCHPOINT 


Purpose: Determine whether the specified breakpoint has been encountered. 


Available on: 80286 or higher in protected mode, Restrictions: DPMI version 0.9 or higher must be 
installed. 
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Registers at call: Return Registers: 
AX = 0B02h CF clear if successful 
BX = watchpoint handle. AX = status flags 


bit 0: watch point has been executed since 
Function 0Bh Subfunctions 00h or 03h 
CF set on error 
AX = error code (DPMI 1.0-+) (8023h) (see 
Function 00h Subfunction 00h) 
Conflicts: None known. 
See Also: Function OBh Subfunctions 00h and 03h 


INTERRUPT 31h - Function OBh, Subfunction 03h 


RESET DEBUG WATCHPOINT 

Purpose: Clear the specified breakpoint's activation flag. 

Available on: 80286 or higher in protected mode. Restrictions: DPMI version 0.9 or higher must be 
installed. 

Registers at call: Return Registers: 

AX = 0B03h CF clear if successful 

BX = watchpoint handle CF set on error 


AX = error code (DPMI 1.0-+) (8023h) (see 
Function 00h Subfunction 00h) 
Conflicts: None known. 
See Also: Function OBh Subfunction 02h 


INTERRUPT 31h - Function 0Ch, Subfunction 00h 
INSTALL RESIDENT HANDLER INITIALIZATION CALLBACK 


Purpose: Request notification of loading or termination of other DPMI programs within the same virtual machine. 


Available on: 80286 or higher in protected mode. Restrictions: DPMI version 1.0 or higher must be 
installed. 
Registers at call: Return Registers: 
AX = 0C00h CF clear if successful 
ES:(E)DI -> resident service provider structure (see CE set on error 
Table 11-14) AX = error code (8015h,8021h,8025h) (see 


Function 00h Subfunction 00h) 
Details: Calling this function declares an intent to provide resident protected mode services after terminating with 
Function 0Ch Subfunction OLh. 
Conflicts: None known. 
See Also: Function 03h Subfunction 03h, AX=0COIh 


Table 11-14. Format of resident service provider structure: 


Offset Size Description 

00h QWORD descriptor for 16-bit data segment 

O8h QWORD descriptor for 16-bit code segment (zeros if not supported) 
10h WORD offset of 16-bit callback procedure 

12h 2BYTEs reserved 

14h QWORD descriptor for 32-bit data segment 

1Ch QWORD descriptor for 32-bit code segment (zeros if not supported) 
24h DWORD _ offset of 32-bit callback procedure 


INTERRUPT 3th - Function 0Ch, Subfunction 01h 
TERMINATE AND STAY RESIDENT 


Purpose: End execution but do not free the program's resources (such as memory). 
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Available on: 80286 or higher in protected mode. Restrictions: DPMI version 1.0 or higher must be 
installed. 

Registers at call: Return Registers: never 

AX =0COIh 


BL = return code 
DX = number of paragraphs of DOS memory to 
reserve (0 or >= 6) 
Details: Should only be used if the program will only provide services to other DPMI programs. Any protected mode 
memory remains allocated to the program unless explicitly freed before this call. Must first call Function 0Ch 
Subfunction 00h or program will simply be terminated. 
Conflicts: None known. 
See Also: Function 0Ch Subfunction 00h, DOS INT 21h Function 3h (chapter 8) 


INTERRUPT 31h - Function 0Dh, Subfunction 00h 
ALLOCATE SHARED MEMORY 


Purpose: Request a block of memory which may be visible at the same address to other DPMI programs in the same 
virtual machine. 


Available on: 80286 or higher in protected mode. Restrictions: DPMI version 1.0 or higher must be 
installed, 
Registers at call: Return Registers: 
AX = 0D00h CF clear if successful 
ES:(E)DI -> shared memory allocation request request structure updated 
structure (see Table 11-15) CF set on error 


AX = error code (8012h, 8013h, 8014h, 8016h, 
8021h) (see Function 00h Subfunction 00h) 
Details: First 16 bytes of memory block will be initialized to zeros on the first allocation, 
Conflicts: None known. 
See Also: Function 05h Subfunction 01h, Function ODh Subfunctions Oth and 02h 


Table 11-15. Format of shared memory allocation request structure: 


00h DWORD __ requested length of shared memory block in bytes 

04h DWORD (return) allocated length of block 

08h DWORD (return) shared memory handle 

0Ch DWORD (return) linear address of memory block 

10h 6BYTEs _ selector:offset32 of ASCIZ name for memory block (name max [28 bytes) 
16h 2BYTEs _ reserved 

[8h 4BYTEs _ reserved (00h) 

INTERRUPT 31h - Function 0Dh, Subfunction 01h 

FREE SHARED MEMORY 


Purpose: Release a previously-allocated block of shared memory; the block itself continues to exist until all 
programs which allocated it have released it. 


Available on: 80286 or higher in protected mode. Restrictions: DPMI version 1.0 or higher must be 
installed, 
Registers at call: Return Registers: 
AX = 0D01h CF clear if successful 
SLDI = shared memory block handle CF set on error 
AX =error code (8023h) (see Function 00h 
Subfunction 00h) 


Details: Handle becomes invalid after this call. DPMJ maintains separate global and virtual machine use counts for 
each shared memory block; when the global use counts reaches zero, the block is finally destroyed. 

Conflicts: None known. 

See Also: Function 05h Subfunction 02h, Function ODh Subfunction 00h 


| 
| 
| 
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INTERRUPT 31h - Function 0Dh, Subfunction 02h 
SERIALIZE SHARED MEMORY 


Purpose: Request either an exclusive or a shared lock on a block of shared memory to prevent conflicting accesses 
to that block. 


Available on: 80286 or higher in protected mode. Restrictions: DPMI version 1.0 or higher must be 
installed. 
Registers at call: Return Registers: 
AX =0D02h CF clear if successful 
SI:DI = shared memory block handle CF set on error 
DX = flags AX = error code (8004h, 8005h, 8017h- 8019h, 
bit 0: return immediately rather than suspending 8023h) (see Function 00h Subfunction 00h) 


if serialization unavailable 

I: shared rather than exclusive serialization 

2-15: reserved (0) 
Details: An exclusive serialization blocks any other serialization attempts for the same block by another virtual 
machine; a shared serialization blocks attempts at exclusive serialization by another virtual machine. Hosts are not 
required to detect deadlock. A client's interrupt handler can cancel a serialization call which caused it to block by 
calling Function 0Dh Subfunction 03h. 
Conflicts: None known. 
See Also: Function 0Dh Subfunctions 00h and 03h 


INTERRUPT 31h - Function 0Dh, Subfunction 03h 
FREE SERIALIZATION ON SHARED MEMORY 


Purpose: Release a previously-granted lock on a block of shared memory. 


Available on: 80286 or higher in protected mode. Restrictions: DPMI version 1.0 or higher must be 
installed. 
Registers at call: Return Registers: 
AX = 0D03h CF clear if successful 
SEDI = shared memory block handle CF set on error 
DX = flags AX = error code (8002h, 8023h) (see Function 00h 
bit 0: release shared serialization rather than Subfunction 00h) 


exclusive serialization 
bit 1: free pending serialization 
bits 2-15: reserved (0) 
Conflicts: None known. 
See Also: Function 0Dh Subfunctions 00h and 02h 


INTERRUPT 31h - Function 0Eh, Subfunction 00h 


GET COPROCESSOR STATUS 

Purpose: Determine whether a coprocessor exists or is being emulated. 

Available on: 80286 or higher in protected mode. Restrictions: DPMI version 1.0 or higher must be 
installed. 

Registers at call: Return Registers: 

AX = OEO0h CF clear 


AX = coprocessor status 
bit 0: numeric coprocessor enabled for current 
client 
bit 1: client is emulating coprocessor 
bit 2: numeric coprocessor is present 
bit 3: host is emulating coprocessor 
instructions 
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bits 4-7: coprocessor type 
0000 none 
0010 80287 
0011 80387 
0100 80486 with numeric coprocessor 
other reserved 
bits 8-15: not used 
Conflicts: None known. 
See Also: Function OEh Subfunction 01h 


INTERRUPT 31h - Function 0Eh, Subfunction 01h 
SET COPROCESSOR EMULATION 


Purpose: Specify whether to enable or emulate the coprocessor. 


Available on: 80286 or higher in protected mode. Restrictions: DPMI version 1.0 or higher must be 
installed. 
Registers at call: Return Registers: 
AX = 0B0Ih CF clear if successful 
BX = coprocessor flag bits CF set on error 
bit 0: enable numeric coprocessor for current AX = error code (8026h) (see Function 00h 
client Subfunction 00h) 


bit 1: client will emulate coprocessor 
bits 2-15: not used 

Conflicts: None known. 

See Also: Function 0Eh Subfunction 00h 


Chapter = | ? 


Virtual DMA Specification 


The Virtual DMA Specification was introduced with the Micro Channel models of the PS/2 series to address prob- 
lems inherent in protected mode use of DMA and the presence of multiple bus masters independently performing 
DMA operations. It contains, among others, functions to allocate buffers at fixed physical addresses and to lock ad- 
dress ranges to prevent multiple DMA operations on the same memory. 


INTERRUPT 4Bh - Function 81h, Subfunction 02h 


GET VERSION 

Purpose: Determine the version of Virtual DMA software installed. 

Available on: All machines. Restrictions: none. 

Registers at call: Return Registers: 

AX = 8102h CF clear if successful 

DX = 0000h AH = major version number (currently 01h) 


AL = minor version number (currently 00h) 
BX = product number 
CX = product revision number 
SI:DI = maximum DMA buffer size in bytes 
DX = flags: 
bit 0: PC/XT bus (DMA in first megabyte 
only) 
1: physical buffer/remap region is in the first 
megabyte 
2: automatic remap is enabled 
3: all memory is physically contiguous 
4-15: reserved (zero) 
CF set on error 
AL = error cade (see Table 12-1) 
Details: Bit 5 of 0040h:007Bh is supposed to be set if VDS is supported, this is apparently not always the case. 
QEMM-386 returns product number 5145h ("QE"). 
Bits 1-11 of the page table entries in Extended DMA Descriptor structures should be zero; bit 0 set if page is pres- 
ent and locked. 
Conflicts: Z,100 $100 vectored line 3 (chapter 2), Common Access Method SCSI interface, draft revision 1.9 (chapter 
6). 
See Also: INT 31 


Table 12-1, DMA Error Codes 


01h region not in contiguous memory 07h invalid memory region 
02h region crossed a physical alignment 08h region was not locked 
boundary 09h number of physical pages greater than table 
03h unable to lock pages length 
04h no buffer available 0Ah_ invalid buffer ID 
05h region too large for buffer OBh copy out of buffer range 
06h buffer currently in use 0Ch invalid DMA channel number 
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Table 12-1, DMA Error Codes (continued) 


ODh disable count overflow OFh — function not supported 
QEh disable count underflow 10h reserved flag bits set in DX 


Table 12-2. Format of DMA descriptor structure (DDS): 


Offset Size Description 

00h DWORD region size 

04h DWORD offset 

08h WORD segment/selector 
OAh WORD buffer ID 

0Ch DWORD physical address 


Table 12-3. Format of Extended DMA descriptor structure (EDDS): 


Offset Size Description 

00h DWORD _ region size 

04h DWORD offset 

08h WORD segment/selector 

OAh WORD reserved 

0Ch WORD number available 

OEh WORD number used 

10h DWORD region 0 physical address 
14h DWORD _ region 0 size in bytes 
18h DWORD _ region 1 physical address 


1Ch DWORD _ region | size in bytes 


Table 12-4, Format of Extended DMA descriptor structure (EDDS) with page table entries: 


Offset Size Description 

00h DWORD region size 

04h DWORD offset 

08h WORD segment/selector 

OAh WORD reserved 

0Ch WORD number available 

OEh WORD number used 

10h DWORD page table entry 0 (same as 80386 page table entry) 


14h DWORD page table entry 1 


INTERRUPT 4Bh - Function 81h, Subfunction 03h 


LOCK DMA REGION 
Purpose: Prevent conflict or address remapping of DMA region during asynchronous operations. 
Available on: All machines. Restrictions: Virtual DMA software must be installed. 
Registers at call: Return Registers: 
AX = 8103h CF clear if successful 
DX = flags DDS physical address field filled in 
bit 0: reserved (zero) DDS buffer ID field filled (0000h if no buffer 
1: data should be copied into buffer (ignored if allocated) 
bit 2 set) 
2; buffer should not be allocated if region is CF set on error 
noncontiguous or crosses a physical AL = error code (see Table 12-1) 


alignment boundary specified by bits 4-5 
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3: don't attempt automatic remap DDS region size field filled with maximum 
4: region must not cross 64K physical alignment contiguous length in bytes 
boundary 


5; region must not cross 128K physical 
alignment boundary 

6-15: reserved (zero) 
DS:SI -> DMA descriptor structure (see Function 

81h Subfunction 02h) 
Conflicts: Z100 $100 vectored line 3 (chapter 2), Common Access Method SCSI interface, draft revision 1.9 
(chapter 6). 
See Also: Function 81h Subfunctions 04h and 0Sh 


INTERRUPT 4Bh - Function 81h, Subfunction 04h 


UNLOCK DMA REGION 
Purpose: Remove lock on DMA region installed by Subfunction 03h. 
Available on: All machines. Restrictions: Virtual DMA software must be installed. 
Registers at call: Return Registers: 
AX = 8104h CF clear if successful 
DX = flags DDS physical address field set 
bit 0: reserved (zero) DDS buffer ID field set (0000h if no buffer 
1; data should be copied out of buffer allocated) 
2-15: reserved (zero) CF set on error 
ES:D] -> DMA descriptor structure (see Function AL = error code (see Table 12-1) 
81h Subfunction 02h) with region size, physical DDS region size field filled with maximum 
address, and buffer ID fields set contiguous length in bytes 


Conflicts: Z100 $100 vectored line 3 (chapter 2), Common Access Method SCSI interface, draft revision 1.9 
(chapter 6). 
See Also: Function 81h Subfunctions 03h and 06h 


INTERRUPT 4Bh - Function 81h, Subfunction 05h 
SCATTER/GATHER LOCK REGION 


Purpose: Prevent remapping of multiple discontinuous regions of memory used by a scatter-read or gather-write 


operation. 
Available on: All machines. Restrictions: Virtual DMA software must be installed. 
Registers at call: Return Registers: 
AX = 8105h CF clear if successful 
DX = flags EDDS number used field set 
bits 0-5: reserved (zero) if DX bit 6 set, lower 12 bits of BX = offset in first 
6: EDDS should be returned with page table page 
entries CF set on error 
7: only present pages should be locked (not- AL & error code (see Table 12-1) 
present pages receive entry of 0000h) EDDS region size field filled with max length in 
8-15: reserved (zero) bytes that can be locked and described in the 
ES:DI -> Extended DMA descriptor structure (see EDDS table 


Table 12-1) region size, linear segment, linear 

offset, and number available fields set 
Conflicts: Z100 $100 vectored line 3 (chapter 2), Common Access Method SCSI interface, draft revision 1.9 
(chapter 6). 
See Also: Function 81h Subfunctions 03h and 06h 


| 
; 





12-4 Virtual DMA Specification 


INTERRUPT 4Bh - Function 81h, Subfunction 06h 
SCATTER/GATHER UNLOCK REGION 


Purpose: Permit remapping of multiple previously locked regions of memory after a scatter-read or gather-write 


operation. 
Available on: All machines. Restrictions: Virtual DMA software must be installed. 
Registers at call: Return Registers: 
AX = 8106h CF clear if successful 
DX = flags CF set on error 
bits 0-5: reserved (zero) AL = error code (see Table 12-1) 


6: EDDS contains page table entries 
7: EDDS may contain not-present pages 
(entry = 0000h) 
8-15: reserved (zero) 
ES:DI -> Extended DMA descriptor structure (see 
Function 81h Subfunction 02h) returned by 
Function 81h Subfunction 05h 
Conflicts: Z100 $100 vectored line 3 (chapter 2), Common Access Method SCSI interface, draft revision 1.9 
(chapter 6). 
See Also: Function 81h Subfunctions 04h and 05h 


INTERRUPT 4Bh - Function 81h, Subfunction 07h 
REQUEST DMA BUFFER 


Purpose: Allocate a region of memory which will not be remapped and may thus be used without explicit locking 
for each DMA operation. 


Available on: All machines. Restrictions: Virtual DMA software must be installed. 
Registers at call: Return Registers: 
AX = 8107h CF clear if successful 
DX = flags DDS physical address and buffer ID set 
bit 0: reserved (zero) DDS region size filled with length of buffer 
1: data should be copied into buffer CF set on error 
2-15: reserved (zero) AL = error code (see Table 12-1) 


ES:DI -> DMA descriptor structure (see Function 
81h Subfunction 02h) with region size set (also 
region offset and region segment if DX bit 1 
set) 
Conflicts: Z100 $100 vectored line 3 (chapter 2), Common Access Method SCSI interface, draft revision 1.9 
(chapter 6). 
See Also: Function 81h Subfunction 08h 


INTERRUPT 4Bh - Function 81h, Subfunction 08h 


RELEASE DMA BUFFFER 

Purpose: Free a previously allocated buffer used for DMA operations. 

Available on: All machines. Restrictions: Virtual DMA software must be installed. 
Registers at call: Return Registers: 

AX = 8108h CF clear if successful 

DX = flags CF set on error 


bit 0: reserved (zero) AL = error code (see Table 12-1) 
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1; data should be copied out of buffer 
2-15: reserved (zero) 
ES:DI -> DMA descriptor structure (see Function 
81h Subfunction 02h) with buffer ID set (also 
region size, region offset, and segment if DX bit 
1 is set) 
Conflicts: 2100 $100 vectored line 3 (chapter 2), Common Access Method SCSI interface, draft revision 1.9 
(chapter 6). 
See Also: Function 81h Subfunction 07h 


INTERRUPT 4Bh - Function 81h, Subfunction 09h 


COPY INTO DMA BUFFER 

Purpose: Place the specified information into a previously allocated buffer in preparation for a DMA write 
operation. 

Available on: All machines. Restrictions: Virtual DMA software must be installed. 
Registers at call: Return Registers: 

AX = 8109h CF clear if successful 

DX = 0000h CF set on error 

ES:DI -> DMA descriptor structure (see Function AL = error code (see Table 12-1) 


81h Subfunction 02h) with buffer ID, region 
segment/offset, and region size fields set 
BX:CX = starting offset into DMA buffer 
Conflicts: Z100 S100 vectored line 3 (chapter 2), Common Access Method SCSI interface, draft revision 1.9 
(chapter 6). 
See Also: Function 81h Subfunction 0Ah 


INTERRUPT 4Bh - Function 81h, Subfunction OAh 


COPY OUT OF DMA BUFFER 

Purpose: Retrieve the contents of a previously allocated buffer after a DMA read operation. 

Available on: Ali machines. Restrictions: Virtual DMA software must be installed, 
Registers at call: Return Registers: 

AX =810Ah CF clear if successful 

DX = 0000h CF set on error 

ES:DI -> DMA descriptor structure (see Function AL = error code (see Table 12-1) 


81h Subfunction 02h) with buffer ID, region 
segment/offset, and region size fields set 
BX:CX = starting offset into DMA buffer 
Conflicts: Z100 $100 vectored line 3 (chapter 2), Common Access Method SCSI interface, draft revision 1.9 
(chapter 6). 
See Also: Function 81h Subfunction 09h 


INTERRUPT 4Bh - Function 81h, Subfunction OBh 
DISABLE DMA TRANSLATION 


Purpose: Turn off the translation of addresses used by DMA operations. 


Available on: All machines. Restrictions: Virtual DMA software must be installed. 
Registers at call: Return Registers: 

AX =810Bh CF clear if successful 

BX = DMA channel number CF set on error 

DX = 0000h AL = error code (see Table 12-1) 


Conflicts: Z100 $100 vectored line 3 (chapter 2), Common Access Method SCSI interface, draft revision 1.9 
(chapter 6). 
See Also: Function 81h Subfunction 0Ch 
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INTERRUPT 4Bh - Function 81h, Subfunction 0Ch 
ENABLE DMA TRANSLATION 


Purpose: Permit the translation of addresses used by DMA operations. 


Available on: All machines. Restrictions: Virtual DMA software must be installed. 
Registers at call: Return Registers: 

AX = 810Ch CF clear if successful 

BX = DMA channel number ZF set if disable count decremented to zero 

DX = 0000h CF set on error 


AL = error code (see Table 12-1) 
Conflicts: Z100 $100 vectored line 3 (chapter 2), Common Access Method SCSI interface, draft revision 1.9 
(chapter 6), 
See Also: Function 81h Subfunction OBh 
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Mouse Support 


In recent years, the mouse has taken a place almost equal to that of the keyboard itself as an input device. Part of the 
reason for its rise in popularity has been the relative ease of using it, since virtually all mice (regardless of manufac- 
turer) make use of the "standard" INT 33h interface established by Microsoft with its first mouse driver. This chapter 
describes that interface. 

Some non-Microsoft drivers provide additional capabilities beyond the ones provided by Microsoft drivers. Those 
calls are described under the Logitech and Mouse Systems headings following the general Microsoft calls. 


Microsoft Mouse 

Microsoft MouseThe Microsoft mouse driver (at version 8.0 as this chapter is being written) is the acknowledged 
standard of the MS-DOS world, and is used by nearly all programs as the interface to the rodent. Note that versions 
prior to 6.24 may not fully support video displays having more than 25 tines of text, or high-resolution video graphics 
modes. Neither do all "Microsoft compatible" drivers from other vendors necessarily support all functions listed here. 


INTERRUPT 10h - Functions F0h thru FAh 
EGA REGISTER INTERFACE LIBRARY 


Purpose: Facilitate support of mouse cursor with EGA video cards. 
Available on: All machines, Restrictions: Microsoft or fully compatible mouse 
driver or EGA.SYS must be installed. 

Details: Support of the mouse pointer requires the ability to modify the video display as the mouse moves, which in 
turn makes it necessary for the mouse driver software to determine the video mode at the instant mouse motion is de- 
tected. The write-only registers of the EGA card make it impossible to get this information directly from the card, so 
the Microsoft mouse drivers include these functions for register interfacing which trap out all BIOS calls that modify 
the EGA registers, and record the register content so that the mouse driver itself can later read the register content 
when required. 

Although these functions are physically included within the mouse driver software, they affect video operation, 
and therefore are described in Chapter 5. 


INTERRUPT 33h - Function 0000h 
RESET DRIVER AND READ STATUS 
Purpose: Determine the type of mouse present and reset both software and hardware for it. 
Available on: All machines. Restrictions: Vector for INT 33h must not be NULL 
(DOS V3.0+ initializes it, earlier 
versions do not). 
Registers at call: Return Registers: 
AX = 0000h AX = status 
0000h hardware/driver not installed 
FFFh hardware/driver installed 
BX = number of buttons 
FFFFh two buttons 
0000h other than two 
0003h Mouse Systems/Logitech mouse 
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Details: To use mouse on a Hercules-compatible monographics card in graphics mode, you must first set 
0040h:0049h to 6 for page 0 or 5 for page 1, and then call this function. The Logitech mouse driver contains the 
signature string "LOGITECH". 

Conflicts: None known. 

See Also: Function 0021h, INT 74h (chapter 2) 


INTERRUPT 33h - Function 0001h 


SHOW MOUSE CURSOR 

Purpose: Make the mouse cursor/pointer visible. 

Available on: All machines. Restrictions: Microsoft or fully compatible mouse 
driver software must be installed. 

Registers at call: Return Registers: n/a 

AX = 0001h 


Details: To avoid leaving "mouse droppings” on the screen, the cursor should always be hidden before any action 
which changes the video display. 

Conflicts: None known. 

See Also: Functions 0002h and 0010h, PC Tools INT 16h Function FFh Subfunction FEh (chapter 33) 


INTERRUPT 33h - Function 0002h 


HIDE MOUSE CURSOR 

Purpose: Make the mouse cursor/pointer invisible on the screen, 

Available on: All machines. Restrictions: Microsoft or fully compatible mouse 
driver software must be installed. 

Registers at call: Return Registers: n/a 

AX = 0002h 


Details: Multiple calls to hide the cursor require multiple calls to Function 0001h to unhide it, as the driver maintains 
a count of the number of times the mouse cursor has been hidden. 

Conflicts: None known. 

See Also: Functions 0001h and 0010h, PC Tools INT 16h Function FFh Subfunction FFh (chapter 33) 


INTERRUPT 33h - Function 0003h 
RETURN POSITION AND BUTTON STATUS 


Purpose: Determine the current location and button status of the mouse. 


Available on: All machines, Restrictions: Microsoft or fully compatible mouse 
driver software must be installed. 

Registers at call: Return Registers: 

AX = 0003h BX = button status 


bit 0 left button pressed if 1 
bit 1 right button pressed if 1 
bit 2 middle button pressed if 1 (Mouse 
Systems/Logitech mouse) 
CX = column 
DX = row 
Conflicts: None known. 
See Also: Functions 0004h and 0OOBh 


INTERRUPT 33h - Function 0004h 
POSITION MOUSE CURSOR 


Purpose: Move the mouse cursor to the specified position. 
Available on: All machines. Restrictions: Microsoft or fully compatible mouse 
driver software must be installed. 
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Registers at call: Return Registers: n/a 

AX = 0004h 

CX =column 

DX = row 

Details: The row and column are truncated to the next lower multiple of the cell size; however, some versions of the 
Microsoft documentation incorrectly state that the coordinates are rounded. 

Conflicts: None known. 

See Also: Function 0003h 


INTERRUPT 33h - Function 0005h 


RETURN BUTTON PRESS DATA 
Purpose: Determine button status, click count, and the location where a button was last pressed. 
Available on: All machines. Restrictions: Microsoft or fully compatible mouse 
driver software must be installed. 
Registers at call: Return Registers: 
AX = 0005h AX = button states 
BX = button bit 0 left button pressed if 1 
0000h left bit 1 right button pressed if 1 
0001h right bit 2 middle button pressed if 1 (Mouse 
0002h middle (Mouse Systems/Logitech Systems/Logitech mouse) 
mouse) BX = number of times specified button has been 


pressed since last call 
CX = column at time specified button was last pressed 
DX = row at time specified button was last pressed 
Conflicts: None known. 
See Also: Function 0006h 


INTERRUPT 33h - Function 0006h 
RETURN BUTTON RELEASE DATA 


Purpose: Determine button status, click count, and the location where a button was last released. 


Available on: All machines. Restrictions: Microsoft or fully compatible mouse 
driver software must be installed. 
Registers at call: Return Registers: 
AX = 0006h AX = button states 
BX = button bit 0 left button pressed if 1 
0000h left bit [ right button pressed if | 
0001h right bit 2 middle button pressed if 1 (Mouse 
0002h middle (Mouse Systems/Logitech Systems/Logitech mouse) 
mouse) BX = number of times specified button has been 


released since last call 
CX = column at time specified button was last released 
DX = row at time specified button was last released 
Conflicts: None known. 
See Also: Function 0005h 


INTERRUPT 33h - Function 0007h 
DEFINE HORIZONTAL CURSOR RANGE 


Purpose: Establish limits on the horizontal motion of the mouse cursor/pointer. 


Available on: All machines. Restrictions: Microsoft or fully compatible mouse 
driver software must be installed. 
Registers at call: Return Registers: n/a 


AX = 0007h 
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CX = minimum column 
DX = maximum column 
Conflicts: None known. 
See Also: Functions 0008h and 0010h 


INTERRUPT 33h - Function 0008h 
DEFINE VERTICAL CURSOR RANGE 


Purpose: Establish limits on the vertical motion of the mouse cursor/pointer. 


Available on: All machines. Restrictions: Microsoft or fully compatible mouse 
driver software must be installed. 

Registers at call: Return Registers: n/a 

AX = 0008h 


CX = minimum row 

DX = maximum row 

Conflicts: None known. 

See Also: Functions 0007h and 0010h 


INTERRUPT 33h - Function 0009h 
DEFINE GRAPHICS CURSOR 


Purpose: Specify the bitmap of the mouse pointer for graphics modes. 
Available on: All machines. Restrictions: Microsoft or fully compatible mouse 
driver software must be installed. 
Registers at call: Return Registers: n/a 
AX = 0009h 
BX = column of cursor hot spot in bitmap (-16 to 
16) 
CX = row of cursor hot spot (-16 to 16) 
ES:DX -> bitmap 
16 words screen mask 
16 words cursor mask 
each word defines the sixteen pixels of a 
row, low bit rightmost 
Conflicts: None known. 
See Also: Functions 000Ah and 0012h 


INTERRUPT 33h - Function QOOAh ; 
DEFINE TEXT CURSOR 


Purpose: Specify the shape and attribute of the mouse cursor/pointer for text modes. 
Available on: All machines. Restrictions: Microsoft or fully compatible mouse 
driver software must be installed. 
Registers at call: Return Registers: n/a 
AX = 000Ah 
BX = hardware/software text cursor 
0000h software 
CX = screen mask 
DX = cursor mask. 
0001h hardware 
CX = start scan line 
DX = end scan line 
Details: When the software cursor is selected, the char/attribute data at the current screen position is ANDed with the 
screen mask and then XORed with the cursor mask, 
Conflicts: None known. 
See Also: Function 0009h 
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INTERRUPT 33h - Function 000Bh 


READ MOTION COUNTERS 

Purpose: Determine the distances the mouse has moved since its position was last read. 

Available on: All machines. Restrictions: Microsoft or fully compatible mouse 
driver software must be installed. 

Registers at call: Return Registers: 

AX = 000Bh CX = number of mickeys mouse moved horizontally 


since last call 
DX = number of mickeys mouse moved vertically 
Details: A mickey is the smallest increment of motion the mouse can sense, typically equal to 1/8 mm or 
approximately 1/200 inch, Positive values indicate down/right. 
Conflicts: None known. 
See Also: Functions 0003h and 001Bh 


INTERRUPT 33h - Function 000Ch 
DEFINE INTERRUPT SUBROUTINE PARAMETERS 


Purpose: Specify the actions to be performed at each mouse event. 


Available on: All machines. Restrictions: Microsoft or fully compatible mouse 
driver software must be installed. 

Registers at call: Return Registers: n/a 

AX = 000Ch 


CX = call mask (see Table 13-1) 
ES:DX -> FAR pointer to Mouse Service Routine 
Details: When the subroutine is called, it is passed the following values: 
AX = condition mask (same bit assignments as call mask) 
BX = button state 
CX = cursor column 
DX = cursor row 
SI = horizontal mickey count 
DI = vertical mickey count 
Some versions of the Microsoft documentation incorrectly state that CX bit 0 requests invocation if the mouse 
cursor moves, and swap the meanings of SI and DI. 
Conflicts: None known. 
See Also: Functions 0018h 


Table 13-1, Mouse Service Routine Call Mask Codes 


Bit Significance 

0 call if mouse moves 

1 call if left button pressed 

2 call if left button released 

3 call if right button pressed 

4 call if right button released 

5 call if middle button pressed (Mouse Systems/Logitech mouse) 

6 call if middle button released (Mouse Sys/Logitech mouse) 

INTERRUPT 33h - Function 000Dh 

LIGHT PEN EMULATION ON 

Purpose: Make the mouse emulate a light pen. 

Available on: All machines. Restrictions: Microsoft or fully compatible mouse 
driver software must be installed. 

Registers at call: Return Registers: n/a 


AX = 000Dh 
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Conflicts: None known. 
See Also: Function 000Eh 


INTERRUPT 33h - Function 000Eh 
LIGHT PEN EMULATION OFF 


Purpose: End light pen emulation. 

Available on: All machines. Restrictions: Microsoft or fully compatible mouse 
driver software must be installed. 

Registers at call: Return Registers: n/a 

AX = 000Eh 

Conflicts: None known. 

See Also: Function 000Dh 


INTERRUPT 33h - Function 000Fh 
DEFINE MICKEY/PIXEL RATIO 


Purpose: Change mouse's sensitivity to movement. 
Available on: All machines, Restrictions: Microsoft or fully compatible mouse 
driver software must be installed. 
Registers at call: Return Registers: n/a 
AX = 000Fh 
CX = number of mickeys per 8 pixels horizontally 
(default 8) 
DX = number of mickeys per 8 pixels vertically 
(default 16) 
Conflicts: None known. 
See Also: Functions 0013h and 001Ah 


INTERRUPT 33h - Function 0010h 


DEFINE SCREEN REGION FOR UPDATING 


Purpose: Indicate to the mouse driver that the specified portion of the display is about to be modified, and the mouse 
cursor should not appear within that area, 


Available on: All machines. Restrictions: Microsoft or fully compatible mouse 
driver software must be installed. 

Registers at call: Return Registers: n/a 

AX = 0010h 


CX,DX = X,Y coordinates of upper left corner 

SI,DI = X,Y coordinates of lower right corner 

Details: The mouse cursor is hidden during updating, and must be explicitly turned on again. 
Conflicts: None known, 

See Also: Functions 0001h 0002h, and 0007h 


INTERRUPT 33h - Function 0012h 
SET LARGE GRAPHICS CURSOR BLOCK 


Purpose: Define a graphics-mode mouse cursor of arbitrary (up to an implementation-dependent limit) size; this is a 
superset of Function 0009h. 


Available on: All machines. Restrictions: Microsoft or fully compatible mouse 
driver software must be installed. 

Registers at call: Return Registers: 

AX = 0012h AX = FFFFh if successful 





BH = cursor width in words 
CH = rows in cursor 
BL = horizontal hot spot (-16 to 16) 
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CL = vertical hot spot (-16 to 16) 

ES:DX -> bit map of screen and cursor maps 
Conflicts: None known, 

See Also: Function 0009h 


INTERRUPT 33h - Function 0013h 
DEFINE DOUBLE-SPEED THRESHOLD 


Purpose: Permit rapid movement of the mouse pointer when the mouse is moved quickly. 


Available on: All machines. Restrictions: Microsoft or fully compatible mouse 
driver software must be installed. 

Registers at call: Return Registers: n/a 

AX=00I3h 


DX = threshold speed in mickeys/second, 
0000h = default of 64/second 
Details: If the mouse’s speed exceeds the given threshold, the cursor's on-screen motion is doubled. 


Conflicts: None known, 
See Also: Functions 000Fh, 001Bh, and 002Ch 


INTERRUPT 33h - Function 0014h 
EXCHANGE INTERRUPT SUBROUTINES 


Purpose: Temporarily replace a mouse service routine (see Function 000Ch). The original routine is returned to 
allow later restoration. 


Available on: All machines. Restrictions: Microsoft or fully compatible mouse 
driver software must be installed. 

Registers at call: Return Registers: 

AX = 0014h CX = call mask of previous interrupt routine 

CX = call mask (see Table 13-1) ES:DX = FAR address of previous interrupt routine 


ES:DX -> FAR routine 
Conflicts: None known. 
See Also: Function 0018h 


INTERRUPT 33h - Function 0015h 
RETURN DRIVER STORAGE REQUIREMENTS 


Purpose: Determine the space required to save the mouse driver's state. 


Available on: All machines. Restrictions: Microsoft or fully compatible mouse 
driver software must be installed. 

Registers at call: Return Registers: 

AX = 0015h BX = size of buffer needed to store driver state 


Conflicts: None known. 
See Also: Functions 0016h and 0017h, Mouse Systems Function 0042h 


INTERRUPT 33h - Function 0016h 


SAVE DRIVER STATE 

Purpose: Copy the mouse driver's state to a user-supplied save buffer, 

Available on; All machines. Restrictions: Microsoft or fully compatible mouse 
driver software must be installed. 

Registers at call; Return Registers: n/a 

AX = 0016h 


BX = size of buffer (see Function 0015h) 

ES:DX -> buffer for driver state 

Details: Although not documented, many drivers appear to require BX on input. 
Conflicts: None known. 

See Also: Functions 0015h and 0017h, Mouse Systems Function 0050h 
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INTERRUPT 33h - Function 0017h 


RESTORE DRIVER STATE 

Purpose: Copy the saved mouse driver state from the user's save buffer back to the driver. 

Available on: All machines. Restrictions: Microsoft or fully compatible mouse 
driver software must be installed. 

Registers at call: Return Registers: n/a 

AX =0017h 


BX = size of buffer (see Function 0015h) 

ES:DX -> buffer containing saved state 

Details: Although not documented, many drivers appear to require BX on input. Some mouse drivers range-check 
the values in the saved state based on the current video mode; thus, the video mode should be restored before the 
mouse driver's state is restored. 

Conflicts: None known. 

See Also: Functions 0015h and 0016h 


INTERRUPT 33h - Function 0018h 
SET ALTERNATE MOUSE USER HANDLER 


Purpose: Provide enhanced mouse capabilities using shift, Alt, and Ctrl keys. 


Available on; All machines. Restrictions: Microsoft or fully compatible mouse 
driver software must be installed. 

Registers at call: Return Registers: 

AX =0018h AX = 0018h if successful 

CX = call mask (see Table 13-2) FFFFh on error 


ES:DX = address of FAR routine 
Details: When the subroutine is called, it is passed the following values: 
AX = condition mask (same bit assignments as call mask) 
BX = button state 
CX = cursor column 
DX = cursor row 
DI = horizontal mickey count 
SI = vertical mickey count 
Up to three handlers can be defined by separate calls to this function. 
Conflicts: None known. 
See Also: Functions 0014h and 0019h 


Table 13-2. Bit Assignments for Alternate User Handler 


Bit Significance 

call if alt key pressed during event 

call if ctrl key pressed during event 
call if shift button pressed during event 
call if right button released 

call if right button pressed 

call if left button released 

call if left button pressed 

call if mouse moves 


INTERRUPT 33h - Function 0019h 
RETURN USER ALTERNATE INTERRUPT VECTOR 


Purpose: Determine the location of the specified alternate interrupt service routine. 
Available on: All machines. Restrictions: Microsoft or fully compatible mouse 
driver software must be installed. 
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Registers at call: Return Registers: 
AX =0019h BX:DX = user interrupt vector 
CX = call mask (see Table 13-2) CX = call mask (0 if not found) 


Details: This function attempts to find a user event handler (defined by Function 0018h) whose call mask matches 


CX. 
Conflicts: None known. 
See Also: Function 0018h 


INTERRUPT 33h - Function 001Ah 


SET MOUSE SENSITIVITY 

Purpose: Combines older functions that set the sensitivity and threshold separately. 

Available on: All machines. Restrictions: Microsoft or fully compatible mouse 
driver software must be installed. 

Registers at call: Return Registers: n/a 

AX =001Ah 

BX = horizontal speed \ 

CX = vertical speed / (see Function 000Fh) 

DX = double speed threshold (see Function 0013h) 

Conflicts: None known. 

See Also: Functions 0013h and 001Bh 

INTERRUPT 33h - Function 001Bh 

RETURN MOUSE SENSITIVITY 

Purpose: Determine the current sensitivity settings. 

Available on: All machines. Restrictions: Microsoft or fully compatible mouse 
driver software must be installed. 

Registers at call: Return Registers: 

AX = 001Bh BX = horizontal speed 


CX = vertical speed 
DX = double speed threshold 


Conflicts: None known. 
See Also: Functions 000Bh and 001Ah 


INTERRUPT 33h - Function 001Ch 


SET INTERRUPT RATE 

Purpose: Adjust the interrupt rate of the InPort mouse. 

Available on: Machines with InPort mouse Restrictions: Microsoft or fully compatible mouse 
installed. driver software must be installed. 

Registers at call: Return Registers: n/a 

AX = 001Ch 

BX = rate 


00h no interrupts allowed 

Olh 30 per second 

02h 50 per second 

03h 100 per second 

04h 200 per second 
Details; This function is only available on the InPort mouse. Values greater than 4 may cause unpredictable driver 
behavior. 
Conflicts: None known. 


INTERRUPT 33h - Function 001Dh 
DEFINE DISPLAY PAGE NUMBER 


Purpose: Control on which video page the mouse pointer is displayed. 
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Available on: All machines. Restrictions: Microsoft or fully compatible mouse 
driver software must be installed. 

Registers at call: Return Registers: n/a 

AX =001Dh 


BX = display page number 

Details: The cursor will be displayed on the specified page. 
Conflicts: None known. 

See Also: Function 001Eh 


INTERRUPT 33h - Function 001Eh 
RETURN DISPLAY PAGE NUMBER 


Purpose: Determine the current display page used by the mouse pointer, 


Available on: All machines, Restrictions: Microsoft or fully compatible mouse 
driver software must be installed. 

Registers at call: Return Registers: 

AX = 001Eh BX = display page number 


Conflicts: None known. 
See Also: Function 001Dh 


INTERRUPT 33h - Function 001Fh 





DISABLE MOUSE DRIVER 

Purpose: Halt operation of the mouse driver. 

Available on: All machines, Restrictions: Microsoft or fully compatible mouse 
driver software must be installed. 

Registers at call: Return Registers: 

AX = 001Fh AX = 001Fh successful 


FFFFh unsuccessful 
ES:BX = vector for INT 33h before mouse driver was 
first installed 
Details: Restores vectors for INT 10h and INT 71h (8086) or INT 74h (286/386). If you restore INT 33h to the 
values returned in ES:BX, driver will be completely disabled. 
Conflicts: None known. 
See Also: Function 0020h \ 


INTERRUPT 33h - Function 0020h 


ENABLE MOUSE DRIVER 

Purpose: Restore operation of the mouse driver after a halt, 

Available on: All machines, Restrictions: Microsoft or fully compatible mouse 
driver software must be installed. 

Registers at call: Return Registers: n/a 

AX = 0020h 


Details: Restores vectors for INT 10h and INT 71h (8086) or INT 74h (286/386) which were removed by Function 
001Fh, 

Conflicts: None known, 

See Also: Function 001Fh 


INTERRUPT 33h - Function 0021h 


SOFTWARE RESET 
Purpose: Resets mouse driver software without affecting the hardware, 
Available on: All machines. Restrictions: Microsoft or fully compatible mouse 


driver software must be installed, 
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Registers at call: Return Registers: 
AX =0021h AX = FFFFh if mouse driver installed 
002th if mouse driver not installed 
BX =2 if mouse driver is installed 
Details: Identical to Function 0000h, but does not reset the mouse. 
Conflicts: None known. 
See Also: Function 0000h 


INTERRUPT 33h - Function 0022h 
SET LANGUAGE FOR MESSAGES 
Purpose: Specify the language in which messages from the mouse software are displayed. 
Available on: All machines. Restrictions: International version of Microsoft or 
fully compatible mouse driver software 
must be installed. 
Registers at call: Return Registers: n/a 
AX = 0022h 
BX = language 
00h English 
Oth French 
02h Dutch 
03h German 
04h Swedish 
05h Finnish 
06h Spanish 
07h Portugese 
08h Italian 
Details: Only available on international versions of the driver; US versions ignore this call. 
Conflicts: None known. 
See Also: Function 0023h 


INTERRUPT 33h - Function 0023h 

GET LANGUAGE FOR MESSAGES 

Purpose: Determine the message language set by Function 0022h. 

Available on: All machines. Restrictions: International version of Microsoft or 
fully compatible mouse driver software 
must be installed. 

Registers at call: Return Registers: 

AX =0023h BX = language (see Function 0022h) 

Details: The US version of the driver always returns zero. 

Conflicts: None known. 

See Also: Function 0022h 


INTERRUPT 33h - Function 0024h 
GET SOFTWARE VERSION AND MOUSE TYPE 


Purpose: Determine the current driver version and the type of mouse present, 


Available on: All machines. Restrictions: Microsoft or fully compatible mouse 
driver software must be installed. 

Registers at call: Return Registers: 

AX = 0024h AX = FFFFh on errorotherwise, 


BH = major version 
BL = minor version 
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CH = type (1=bus, 2=serial, 3=InPort, 4=PS/2, 
5=HP) 
CL = interrupt (0=PS/2, 2=IRQ2, 
3=IRQ3,...,7=IRQ7) 
Conflicts: None known. 
See Also: Function 004Dh 


INTERRUPT 33h - Function 0026h 


Unknown Function 

Purpose: unknown. 

Available on: All machines. Restrictions: Microsoft or fully compatible mouse 
driver software must be installed. 

Registers at call: Return Registers: unknown. 

AX = 0026h 


Details: Called by the newest Microsoft applications. 
Conflicts: None known. 


INTERRUPT 33h - Function 002Ch 


SET ACCELERATION PROFILES 


Purpose: Define one or more relations between the actual mouse speed and the speed of the mouse cursor. The 
older double-speed threshold is a special case of an acceleration profile. 


Available on: All machines. Restrictions: Microsoft or fully compatible mouse 
driver software must be installed. 

Registers at call: Return Registers: n/a 

AX = 002Ch 


ES:DX -> name of file containing profiles 

Details: The mouse software includes an example set of acceleration profiles in the file MOUSEPRO.FIL. 
Conflicts: None known. 

See Also: Functions 0013h and 002Dh 


INTERRUPT 33h - Function 002Dh 


SELECT ACCELERATION PROFILE 


Purpose: Begin using a previously defined relation between the actual mouse speed and the speed of the mouse 
cursor. 


Available on: All machines. Restrictions: Microsoft or fully compatible mouse 
driver software must be installed. 

Registers at call: Return Registers: n/a 

AX = 002Dh 


BX = acceleration level (O1h to 04h) 

Details: An acceleration of FFFFh appears to be legal as well, since it is used by the MS Control Panel v7.04. 
Conflicts; None known, 

See Also: Functions 0013h and 002Ch 


INTERRUPT 33h - Function 004Dh 
MS MOUSE, LOGITECH - RETURN POINTER TO COPYRIGHT STRING 


Purpose: Determine the address of the copyright statement embedded within the mouse driver. 


Available on: Ali machines. Restrictions: Microsoft or fully compatible mouse 
driver software must be installed. 

Registers at call: Return Registers: 

AX = 004Dh ES:DI -> copyright message "Copyright 1983 


Microsoft ***" 
Conflicts: None known. 
See Also: Functions 0024h and 006Dh 
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INTERRUPT 33h - Function 006Dh 
MS MOUSE, LOGITECH - GET VERSION STRING 


Purpose: Determine the version of the Microsoft driver to which the mouse software corresponds. 


Available on: All machines. Restrictions: Microsoft or fully compatible mouse 
driver software must be installed. 

Registers at call: Return Registers: 

AX =006Dh ES:DI -> Microsoft version number of resident driver 


Conflicts: None known. 
See Also: Function 004Dh 


Logitech Mouse 
Most Logitech mice have three buttons as opposed to the Microsoft mouse, which has two buttons. As a result, some 


of the functions in the Microsoft section above indicate extra bits for the three-button mice. 


INTERRUPT 33h - Function 1D6Ch 
GET COMPASS PARAMETER 


Purpose: Determine the current relation between the direction of mouse movement and the direction of the mouse 
cursor’s movement, 


Available on: All machines. Restrictions: Logitech mouse driver software must be 
installed. 

Registers at call: Return Registers: 

AX = 1D6Ch BX = direction (O=north, 1=south, 2=east, 3=west) 


Conflicts: None known. 
See Also: Function {B6Ch 


INTERRUPT 33h - Function 1E6Ch 
SET COMPASS PARAMETER 


Purpose: Specify the relation between the direction of mouse movement and the direction of the mouse cursor's 
movement. 


Available on: All machines. Restrictions: Logitech mouse driver software must be 
installed. 

Registers at call: Return Registers: n/a 

AX = LE6Ch 


BX = direction (O=north, |=south, 2=east, 3=west) 
Conflicts: None known. 
See Also: Function 1D6Ch 


INTERRUPT 33h - Function 1F6Ch 
GET BALLISTICS INFORMATION 


Purpose: Determine how much the mouse cursor's speed increases as the mouse's speed increases. 


Available on: All machines. Restrictions: Logitech mouse driver software must be 
installed. 

Registers at call: Return Registers: 

AX = IF6Ch BX = O=off, l=on 


CX = Islow, 2=high 
Conflicts: None known. 
See Also: Functions 002Ch and 236Ch 


INTERRUPT 33h - Function 206Ch 
SET LEFT OR RIGHT PARAMETER 


Purpose: Specify whether the mouse is left-handed or right-handed. 
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Available on: All machines. Restrictions: Logitech mouse driver software must be 
installed. 

Registers at call: Return Registers: n/a 

AX = 206Ch 


BX = parameter (00h = right, FFh = left) 
Conflicts: None known. 
See Also: Function 216Ch 


INTERRUPT 33h - Function 216Ch 
GET LEFT OR RIGHT PARAMETER 


Purpose: Determine whether the mouse is currently left-handed or right-handed. 


Available on: All machines. Restrictions: Logitech mouse driver software must be 
installed. 

Registers at call: Return Registers: 

AX =216Ch BX = parameter (00h = right, FFh = left) 


Conflicts: None known, 
See Also: Function 206Ch 


INTERRUPT 33h - Function 226Ch 
REMOVE DRIVER FROM MEMORY 


Purpose: Free the memory used by the mouse driver. 


Available on: All machines. Restrictions: Logitech mouse driver software must be 
installed. 

Registers at call: Return Registers: n/a 

AX = 226Ch 


Details: This only frees memory; it does not restore hooked interrupts. 
Conflicts: None known. 


INTERRUPT 33h - Function 236Ch 
SET BALLISTICS INFORMATION 


Purpose: Specify how much the mouse cursor's speed increases as the mouse's speed increases, 


Available on: All machines. Restrictions: Logitech mouse driver software must be 
installed. 

Registers at call: Return Registers: n/a 

AX = 236Ch 

BX = 0=off, [=on 


CX = l=low, 2shigh 
Conflicts: None known. 
See Also: Functions 002Ch and 1F6Ch 


INTERRUPT 33h - Function 246Ch 
GET PARAMETERS AND RESET SERIAL MOUSE 


Purpose: Determine the current settings for the mouse hardware and place the mouse port in a known initial state, 


Available on: All machines. Restrictions: Logitech mouse driver software must be 
installed, 

Registers at call: Return Registers: 

AX = 246Ch AX = FFFFh if driver installed for serial mouse 


ES:DX -> parameter table buffer (Table 13-3) 
Conflicts: None known. 
See Also: Function 256Ch and Microsoft Function 0000h 











Table 13-3. Format of parameter table: 
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Offset Size Description 

00h WORD baud rate divided by 100 (serial mouse only) 
02h WORD emulation (serial mouse only) 

04h WORD report rate (serial mouse only) 

06h WORD firmware revision (serial mouse only) 

08h WORD 0 (serial mouse only) 

OAh WORD port (serial mouse only) 

0Ch WORD physical buttons 

OEh WORD logical buttons 


INTERRUPT 33h - Function 256Ch 
SET PARAMETERS 


Purpose: Specify new settings for the mouse hardware. 


Available on: All machines. 


Registers at call: 

AX = 256Ch 

BX = 00h set baud rate (serial mouse only) 
CX = rate (0=1200, 1=2400, 2=4800, 
3=9600) 

BX = Oth set emulation (serial mouse only) 
CX = emulation 
0 =5 byte packed binary 
1 =3 byte packed binary 
2 = hexadecimal 
3 = relative bit pad 
4 = not supported 
5 = MM Series 
6 = not supported 
7 = Microsoft 

BX = 02h set report rate (serial mouse only) 
CX = rate (0=10, 1=20, 2=35, 3=50, 4=70, 
5=100, 6=150) 

BX = 03h set port (serial mouse only) 
CX = port (1, 2) 

BX = 04h set mouse logical buttons 
CX = buttons (2, 3) 

Conflicts: None known. 

See Also: Function 246Ch 


INTERRUPT 33h - Function 266Ch 
GET VERSION 


Restrictions: Logitech mouse driver software must be 
installed. 

Return Registers: 

AX = FFFFh if driver installed for serial mouse 


Purpose: Determine which version of the Logitech mouse software is loaded. 


Available on: All machines. 
Registers at call: 
AX = 266Ch 


Conflicts: None known. 
See Also: Microsoft Mouse Function 006Dh 


Restrictions: Logitech mouse driver software must be 
installed. 

Return Registers: 

BX ='SS' 

CH = major version number (ASCTI digit) 

CL = minor version number (ASCII digit) 
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INTERRUPT 33h - Function 276Ch 


Unknown Function 

Purpose: This function apparently tries to set the mouse to emulate an MM Series mouse at 2400 bps. 

Available on: All machines. Restrictions: Logitech mouse driver software must be 
installed. 

Registers at call: Return Registers: n/a 

AX =276Ch 

Conflicts: None known. 

Mouse Systems PCMOUSE 


As with Logitech, most Mouse Systems mice have three buttons, and thus make use of an additional bit for many of 
the functions listed in the Microsoft section. In addition to the standard INT 33h functions, the PCMOUSE provides 
its own functions for saving and restoring the driver's state; these presumably predate the Microsoft equivalents. 


INTERRUPT 33h - Function 0042h 
GET MSMOUSE STORAGE REQUIREMENTS 


Purpose: Determine how much space is needed to store the driver's state. 


Available on: All machines, Restrictions: Mouse Systems mouse software must be 
installed, 

Registers at call: Return Registers: 

AX = 0042h AX = FFFFh if successful 


BX = buffer size in bytes for functions 50h and 52h 
= 0000h MSMOUSE not installed 
= 0042h Functions 42h, 50h, and 52h are not 


supported 
Conflicts: None known. 
See Also: Function 0050h, Microsoft Mouse Function 0015h 
INTERRUPT 33h - Function 0050h 
SAVE MSMOUSE STATE 
Purpose: Copy the driver's current state into a user-provided buffer. 
Available on: All machines. Restrictions: Mouse Systems mouse software must be 
installed. 
Registers at call: Return Registers: 
AX = 0050h AX = FFFFh if successful 


BX = buffer size 

ES:DX -> buffer 

Conflicts: None known. 

See Also: Functions 0042h and 0052h, Microsoft Mouse Function 0016h 


INTERRUPT 33h - Function 0052h 


RESTORE MSMOUSE STATE 

Purpose: Copy a previously-stored state from the specified buffer back into the mouse driver. 

Available on: All machines. Restrictions: Mouse Systems mouse software must be 
installed, 

Registers at call: Return Registers: 

AX = 0052h AX = FFFFh if successful 


BX = buffer size 

ES:DX -> buffer 

Conflicts: None known. 

See Also: Function 0050h, Microsoft Mouse Function 0017h 
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Microsoft Windows 


Microsoft Windows is currently the most popular graphical user interface for the IBM PC family. In addition to its 
graphical interface, it has some multitasking abilities, though only specially-written programs can be multitasked un- 


less running on a 386 or higher processor. Other multitaskers will be covered in chapters 15 through 18. 


Tn addition to the calls listed here, the EGA.SYS driver uses INT 2Fh Function BCh, It is covered in chapter 8 be- 


cause EGA.SYS is now included with DOS 5.0 as well as Windows. 


MS WINDOWS 


The calls in this section are provided by Windows itself, INT 2Fh Function 16h comprises an API for non-Windows 
programs (DOS device drivers, TSRs, and applications) to cooperate with multitasking under Windows/386 2.x and 
Windows 3.0 and higher enhanced mode. Some of those calls are also supported by the Microsoft 80286 DOS ex- 


tender in Windows standard mode. 


INTERRUPT 16h - Function 6Fh, Subfunction 00h 
Unknown Function 


Purpose: uaknown, 


Available on: All machines, Restrictions: unknown. 
Registers at call: Return Registers: 

AX = 6F00h BX = 4850h 

BX = 0000h other unknown. 


other unknown. 
Details: This function is called by recent Microsoft Mouse drivers. 
Conflicts; None known, 


INTERRUPT 2Fh - Function 16h, Subfunction 00h 
MS WINDOWS ENHANCED MODE INSTALLATION CHECK 


Purpose: Determine whether MS Windows/386 version 2.x or MS Windows 3.x in enhanced mode is running, 


Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AX = 1600h AL = 00h if Windows 3.x enhanced mode or 


Windows/386 2.x not running 
AL = 80h if Windows 3.x enhanced mode or 
Windows/386 2.x not running 
AL= 0th if Windows/386 2.x running 
AL = FFh if Windows/386 2.x running 
AL = anything else 
AL = Windows major version number> = 3 
AH = Windows minor version number 
Conflicts: None known. 
See Also: Function 46h Subfunction 80h 
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INTERRUPT 2Fh - Function 16h, Subfunction 02h 


GET API ENTRY POINT 

Purpose: Determine address to call to invoke Windows/386 functions. 

Available on: All machines. Restrictions: MS Windows/386 version 2.x must be 
running. 

Registers at call: Return Registers: 

AX = 1602h ES:DI -> Windows/386 2.x API procedure entry point 


Details: This interface is supported in Windows 3.x only for 2.x compatibility to get the current virtual machine 
(VM) ID in Windows/386 2.x: 

AX = 0000h 

ES:DI -> return address 

JUMP to address returned from INT 2Fh Function 16h Subfunction 02h 
After JUMP, at return address: 

BX = current VM ID. 


INTERRUPT 2Fh - Function 16h, Subfunction 05h 
WINDOWS ENHANCED MODE & 286 DOSX INIT BROADCAST 


Purpose: Called by Windows to allow programs to perform any preparations necessary for compatibility with 
Windows execution, or prevent Windows from starting up if any incompatible programs are loaded. 


Available on: All machines, Restrictions: MS Windows 3.0 or higher must be 
running in standard or enhanced mode. 

Registers at call: Return Registers: 

AX = 1605h CX = 0000h if okay for Windows to load 

ES:BX = 0000h:0000h CX <> 0 if Windows should not load 

DS:SI = 0000h:0000h ES:BX -> startup info structure (Table 14-1) 

CX = 0000h DS:SI -> virtual86 mode enable/disable callback or 

DX = flags 0000h:0000h 


bit 0 = 0 if Windows enhanced-mode 
initialization 
bit 0 = 1 if Microsoft 286 DOS extender 
initialization 
bits 1-15 reserved (undefined) 
DI = version number (major in upper byte, minor in 

lower) 

Details: The Windows enhanced mode loader and Microsoft 286 DOS extender will broadcast an INT 2Fh Function 
16h Subfunction O5h call when initializing. Any DOS device driver or TSR can watch for this broadcast and return 
the appropriate values. If the driver or TSR returns CX nonzero, it is also its responsibility to display an error 
message. Each handler must first chain to the prior INT 2F handler with registers unchanged before processing the 
call, 

If the handler requires local data on a per-VM basis, it must store the retumed ES:BX in the "next" field of a 
startup info structure and return a pointer to that structure in ES:BX, A single TSR may set the V86 mode 
enable/disable callback; if DS:SI is already nonzero, the TSR must fail the initialization by setting CX nonzero. 
Conflicts; None known. 

See Also: Function 16h Subfunctions 06h and 08h 


Table 14-1, Format of Startup Information Structure: 


Offset Size Description 

00h 2BYTEs major, minor version of info structure 

02h DWORD pointer to next startup info structure 

06h DWORD pointer to ASCIZ name of virtual device file or 0000h:0000h 
OAh DWORD virtual device reference data (only used if above nonzero) 


OEh DWORD pointer to instance data records (Table 14-2) or 0000h:0000h 
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Table 14-2. Format of One Instance Item in Array: 


Offset Size Description 

00h DWORD address of instance data (end of array if 0000h:0000h) 
04h WORD size of instance data 

Virtual mode enable/disable procedure called Return Registers: 
with: CF set on error 

AX =0000h disable V86 mode CE clear if successful 
AX =0001h enable V86 mode interrupts disabled 


interrupts disabled 


INTERRUPT 2Fh - Function 16h, Subfunction 06h 
WINDOWS ENHANCED MODE & 286 DOSX EXIT BROADCAST 


Purpose: Called by Windows to allow programs to perform any cleanup necessary for resuming standard DOS 


operation. 

Available on: All machines. Restrictions; MS Windows 3.0 or higher must be 
running in standard or enhanced mode. 

Registers at call: Return Registers: n/a 

AX = 1606h 

DX = flags 


bit 0 = 0 if Windows enhanced-mode exit 
bit 0 = 1 if Microsoft 286 DOS extender exit 
bits 1-15 reserved (undefined) 
Details: If the init broadcast fails (Function 16h Subfunction OSh returned CX <> 0), then this broadcast will be 
issued immediately. This call will be issued in real mode, 
Conflicts: None known, 
See Also: Function 16h Subfunctions 05h and 09h 


INTERRUPT 2Fh - Function 16h, Subfunction 07h 
VIRTUAL DEVICE CALL OUT API 


Purpose: Called by Windows virtual devices to communicate with DOS device drivers. 


Available on: All machines. Restrictions: MS Windows 3.0 or higher must be 
running. 
Registers at call: Return Registers: device-dependent 
AX = 1607h 
BX = virtual device ID (see INT 2Fh Function 16h 
Subfunction 84h) 


Details: More of a convention than an API, this call specifies a standard mechanism for Windows enhanced-mode 
virtual devices (VxD's) to talk to DOS device drivers and TSRs. 

Conflicts: None known, 

See Also: Function 16h Subfunctions OSh and 84h 


INTERRUPT 2Fh - Function 16h, Subfunction 08h 
WINDOWS ENHANCED MODE INIT COMPLETE BROADCAST 


Purpose: Called by Windows to inform programs that Windows is fully operational. 


Available on: All machines. Restrictions: MS Windows 3.0 or higher must be 
running. 

Registers at call: Return Registers: n/a 

AX = 1608h 


Details: Called after all installable devices have been initialized. Real-mode software may be called between the 
Windows enhanced-mode init call (Function 16h Subfunction 05h) and this call; the software must detect this 
situation. 
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Conflicts: None known. 
See Also: Function 16h Subfunctions 05h and 09h 


INTERRUPT 2Fh - Function 16h, Subfunction 09h 
WINDOWS ENHANCED MODE BEGIN EXIT BROADCAST 


Purpose: Called by Windows to inform programs that it is about to terminate. 


Available on: All machines. Restrictions: MS Windows 3.0 or higher must be 
running, 

Registers at call: Return Registers: n/a 

AX = 1609h 


Details: Called at the beginning of a normal exit sequence; not made in the event of a fatal system crash. 
Conflicts: None known. 
See Also: Function 16h Subfunctions 06h and 08h 


INTERRUPT 2Fh - Function 16h, Subfunction 80h 
RELEASE CURRENT VIRTUAL MACHINE TIME-SLICE 


Purpose: Inform Windows (or OS/2, DOS 5, or DPMI hosts) that the caller is idle and does not need the rest of its 
time slice. 


Available on: All machines. Restrictions: MS Windows 3.0+, OS/2 v2.0+, DPMI 
v1.0+, or DOS 5.0+ must be running. 

Registers at call: Return Registers: 

AX = 1680h AL = 00h if the call is supported 


AL = 80h (unchanged) if the call is not supported 
Details: Programs can use this function even when not running under Windows in 386 enhanced mode, because 
OS/2 can use the call to detect idleness even though it does not support the complete Windows enhanced-mode API. 
This call is supported by the DPMI specification version 1.0, will be supported in OS/2 2.0 for multitasking DOS 
applications, and is reportedly supported by DOS 5.0. This call does not block the program; it merely gives up the 
remainder of the time slice and must thus be called repeatedly as long as the program remains idle. It should only be 
used by non- Windows programs. 
Conflicts: None known. 
See Also: TopView INT 15h Function 10h Subfunction 00h (chapter 15) 


INTERRUPT 2Fh - Function 16h, Subfunction 81h 
BEGIN CRITICAL SECTION 


Purpose: Inform Windows that it should temporarily halt task-switching while the calling program performs 
nonreentrant actions. 


Available on: All machines. Restrictions: MS Windows version 3+ must be 
running, 

Registers at call: Return Registers: n/a 

AX = 1681h 


Details: Used to prevent a task switch from occurring. Should be followed by a call to Function 16h Subfunction 82h 
as soon as possible. Nested calls are allowed, and must be followed by an appropriate number of “end critical 
section" calls. Not supported in Windows/386 2.x. Get INDOS flag with INT 21h Function 34h and increment by 
hand, 

Conflicts: None known. 

See Also: Function 16h Subfunction 82h, TopView INT 15h Function 10h Subfunction 1Bh (chapter 15), DOS INT 
21h Function 34h (chapter 8) 


INTERRUPT 2Fh - Function 16h, Subfunction 82h 
END CRITICAL SECTION 


Purpose: Inform Windows that it may resume task-switching. 
Available on: All machines. Restrictions: MS Windows version 3+ must be 
running. 





Microsoft Windows 14-5 


Registers at call: Return Registers: n/a 

AX = 1682h 

Details: Not supported in Windows/386 2.x. Get InDOS flag with INT 21h Function 34h and decrement by hand, 
taking care not to decrement InDOS flag through zero. 

Conflicts: None known. 

See Also: Function 16h Subfunction 81h, TopView INT 15h Function 10h Subfunction 1Ch (chapter 15), DOS INT 
21h Function 34h (chapter 8) 


INTERRUPT 2Fh - Function 16h, Subfunction 83h 
GET CURRENT VIRTUAL MACHINE ID 


Purpose: Determine the number identifying the virtual machine in which the caller is running. 


Available on: All machines. Restrictions: MS Windows version 3+ must be 
running. 

Registers at call: Return Registers: 

AX = 1683h BX = current virtual machine (VM) ID 


Details: Windows itself currently runs in VM 1, but this can't be relied upon. VM IDs are reused when VMs are 
destroyed. An ID of 0 will never be returned. 

Conflicts: None known. 

See Also: Function 16h Subfunctions 84h and 85h 


INTERRUPT 2Fh - Function 16h, Subfunction 84h 
GET DEVICE API ENTRY POINT 


Purpose: Determine the address to call in order to communicate with a virtual device. 


Available on: All machines. Restrictions: MS Windows version 3+ must be 
running. 

Registers at call: Return Registers: 

AX = 1684h ES:DI -> VxD API entry point, or 0:0 if the VxD does 

BX = virtual device (VxD) ID (Table 14-3) not support an API 


ES:DI = 0000h:0000h 

Details: Some Windows enhanced-mode virtual devices provide services that applications can access. For example, 
the Virtual Display Device (VDD) provides an API used in turn by WINOLDAP. 

Conflicts: None known. 

See Also: Function 16h Subfunction 83h 


Table 14-3. Values for VxD ID: 


Olh VMM Virtual Machine Manager 

02h Debug 

03h VPICD Virtual Prog. Interrupt Controller (PIC) Device 
04h VDMAD _ Virtual Direct Memory Access (DMA) Device 
05h VTD Virtual Timer Device 

06 V86MMGR Virtual 8086 Mode Device 

07h PAGESWAP Paging Device 

08) Parity 

09) Reboot 

OAh VDD Virtual Display Device (GRABBER) 

OBh VSD Virtual Sound Device 

0Ch VMD Virtual Mouse Device 

ODh VKD Virtual Keyboard Device 

0E VCD Virtual COMM Device 

OF! VPD Virtual Printer Device 

10h VHD Virtual Hard Disk Device 

1th VMCPD 

12h EBIOS Reserve EBIOS page (e.g., on PS/2) 

13h BIOSXLAT Map ROM BIOS API between prot & V86 mode 
14] VNETBIOS Virtual NetBIOS Device 
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Table 14-3. Values for VxD ID (continued): 


15h DOSMGR 

16h WINLOAD 

17h SHELL 

18h VMPoll 

19h VPROD 

1Ah DOSNET _ assures network integrity across VMs 
1Bh VED Virtual Floppy Device 

1Ch VDD2 Secondary display adapter 

1Dh WINDEBUG 

1Eh TSRLoad _ TSR instance utility 


Details: The high bit of the VxD ID is reserved for future use. The next 10 bits are the OEM number which is 
assigned by Microsoft. The low 5 bits are the device number. 


INTERRUPT 2Fh - Function 16h, Subfunction 85h 


SWITCH VMs AND CALLBACK 

Purpose: Force execution of a subroutine in a specific virtual machine. 

Available on: All machines. Restrictions: MS Windows version 3+ must be 

running. 

Registers at call: Return Registers: 

AX = 1685h CF set on error 

BX = VM ID of virtual machine to switch to AX = error code 

CX = flags Olh invalid VM ID 
bit 0 wait until interrupts enabled 02h invalid priority boost 
bit | wait until critical section unowned. 03h invalid flags 
bits 2-15 reserved (zero) CF clear if successful 

DX:SI = priority boost (see VMM.INC) event will be or has been called 


ES;DI -> FAR procedure to callback 

Details: Some DOS devices, such as networks, need to call functions in a specific VM. This call forces the 
appropriate VM to be installed. The callback procedure must preserve all registers and return with IRET. 

Conflicts: None known. 

See Also: Function 16h Subfunction 83h, DESQview INT 15h Function 11h Subfunction 17h (chapter 15) 


INTERRUPT 2Fh - Function 46h, Subfunction 80h 


INSTALLATION CHECK 

Purpose: Determine whether Microsoft Windows 3.0 is running in real or standard mode. 

Available on: All machines. Restrictions: none. 

Registers at call: Return Registers: 

AX = 4680h AX = 0000h if MS Windows 3.0 is running in real or 


standard mode 
nonzero if Windows 3.0 running in enhanced 
mode, Windows prior to 3.0 is running, or 
Windows is not present. 
Details: This function is not officially documented. Microsoft has indicated that future versions will provide an 
installation check which works in all modes. 
Conflicts: None known. 
See Also: Function 16h Subfunction 00h 


MS WINDOWS "WiNOLDAP” 
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WinOldAp (WINOLDAP.MOD) is a Microsoft Windows extension supporting "old" (character-mode) application 
access to Dynamic Data Exchange, menus, and the Windows clipboard. 


INTERRUPT 2Fh - Function 17h, Subfunction 00h 
IDENTIFY WinOldAp VERSION 

Purpose: Determine which version of WinOldAP is installed. 
Available on: All machines. 


Registers at call: 
AX =1700h 


Restrictions: MS Windows version 3.0+ WINOLDAP 
must be running. 

Return Registers: 

AX = t700h if this version of WINOLDAP does not 
support the clipboard 

AX <> 1700h 
AL = WINOLDAP major version 
AH = WINOLDAP minor version 


Details: This installation check DOES NOT follow the format used by other software. 


Conflicts: None known, 


INTERRUPT 2Fh - Function 17h, Subfunction Oth 
OPEN CLIPBOARD 


Purpose: Prepare to manipulate the clipboard. 
Available on: All machines. 


Registers at call: 
AX = 1701h 


Conflicts: None known, 


INTERRUPT 2Fh - Function 17h, Subfunction 02h 
EMPTY CLIPBOARD 


Purpose: Delete the entire contents of the clipboard. 
Available on: All machines, 


Registers at call: 
AX = 1702h 


Conflicts: None known. 


INTERRUPT 2Fh - Function 17h, Subfunction 03h 
SET CLIPBOARD DATA 


Restrictions: MS Windows version 3.0+ WINOLDAP 
must be running, 

Return Registe rs: 

AX =0000h — clipboard is already open 

AX nonzero — successful 


Restrictions; MS Windows version 3.0+ WINOLDAP 
must be running. 

Return Registers: 

AX =0000h failure 

AX nonzero clipboard has been emptied 


Purpose: Specify the data to be stored in the clipboard and its type. 


Available on; All machines. 


Restrictions: MS Windows version 3.0+ WINOLDAP 
must be running. 
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Registers at call: 
AX = 1703h 
DX = clipboard format supported by WinOldAp: 


Return Registers: 
AX = 0000h failure 
AX nonzero data copied into the clipboard 


Oth text 
02h bitmap 
03h metafile picture 
04h SYLK 
05h DIF 
06h TIFF 
07h OEM text 
ES:BX -> data (Tables 14-4 and 14-5) 
SI:CX = size of data 
Conflicts: None known. 
See Also: Function 17h Subfunctions 04h and 05h 


Table 14-4, Format of Bitmap: 


Offset Size Description 

00h WORD type (0000h) 

02h WORD width of bitmap in pixels 
04h WORD height of bitmap in pixels 
06h WORD bytes per line 

08h BYTE number of color planes 
09h BYTE number of adjacent color bits in pixel 
OAh DWORD pointer to start of data 
OEh WORD width in 0.1mm units 

10h WORD height in 0.1mm units 
12h NBYTEs _ bitmap data 


Table 14-5. Format of Metafile Picture: 


Offset Size Description 

00h WORD mapping mode 

02h WORD X extent 

04h WORD Y extent 

06h WORD picture data 

INTERRUPT 2Fh - Function 17h, Subfunction 04h 
GET CLIPBOARD DATA SIZE 


Purpose: Determine the amount of data of a particular type stored in the clipboard. 
Available on: All machines. Restrictions: MS Windows version 3.0+ WINOLDAP 
must be running. 
Return Registers: 
DX:AX = size of data in bytes, including any headers 
Dx:AX = 0 no data of the specified format in the 
clipboard 


Registers at call: 

AX = 1704h 

DX = clipboard format supported by WinOldAp 
(see Function 17h Subfunction 03h) 

Conflicts: None known, 

See Also: Function 17h Subfunctions 03h and 05h 


INTERRUPT 2Fh - Function 17h, Subfunction 05h 

GET CLIPBOARD DATA 

Purpose: Retrieve the data of a particular type stored in the clipboard. 

Available on: All machines. Restrictions: MS Windows version 3.0+ WINOLDAP 
must be running. 
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Registers at call: Return Registers: 
AX = 1705h AX=0000h — error, or no data of the specified format 
DX = clipboard format supported by WinOldAp in clipboard 

(see Function 17h Subfunction 03h) AX nonzero — success 


ES:BX -> buffer 
Conflicts: None known. 
See Also: Function 17h Subfunction 04h 


INTERRUPT 2Fh - Function 17h, Subfunction 08h 


CLOSE CLIPBOARD 

Purpose: Indicate that clipboard manipulation is complete. 

Available on: All machines. Restrictions: MS Windows version 3.0+ WINOLDAP 
must be running. 

Registers at call: Return Registers: 

AX = 1708h AX = 0000h failure 


AX nonzero success 
Conflicts: None known. 


INTERRUPT 2Fh - Function 17h, Subfunction 09h 


COMPACT CLIPBOARD 

Purpose: Combine any unused spaces in the clipboard into a single region. 

Available on: All machines. Restrictions; MS Windows version 3.0+ WINOLDAP 
must be running. 

Registers at call: Return Registers: 

AX = 1709h DX:AX = number of bytes in largest block of free 

SI:CX = desired size in bytes memory 


Details: WinOldAp is responsible for including the size of any headers. 
Conflicts: None known. 


INTERRUPT 2Fh - Function 17h, Subfunction OAh 
GET DEVICE CAPABILITIES 


Purpose: Determine the parameters of the specified device or what types of operations it supports. 


Available on: All machines. Restrictions: MS Windows version 3.0+ WINOLDAP 
must be running. 
Registers at call: Return Registers: 
AX = 170Ah AX = integer value of the desired item 
DX = GDI information index (see Table ) 
(see Table ) 


Details: This function returns the device-capability bits for the given display 
Conflicts: None known. 
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TopView and DESQview/QEMM 


The first multiple-application system introduced for MS-DOS systems was IBM’s Top View package. The first such 
system to gain wide acceptance, however, was a TopView-compatible multitasker called DESQview, from Quarter- 
deck Office Systems. 

While it is almost impossible to find a TopView application in use today, DESQview is very much alive and well. 
This chapter describes the functions used by both systems; those which apply to both are identified primarily as 
TopView functions, while those available only under DESOview are so noted. The few functions that were available 
for TopView, but which are not available under DESQview are noted. The names given in this chapter reflect those 
used by DESQview; the TopView nomenclature may differ. 

Although not specifically stated here, most of the Top View functions are also available under Task View (and its 
follow-on OmniView) by Sunny Hill Software. See chapter 17 for additional calls that are unique to OmniView. 

This chapter is divided into four sections: Top View calls, DESQview calls, the DESQview External Device Inter- 
face, and Quarterdeck Programs (QEMM, QRAM, Manifest, and VIDRAM). 





TopView 

INTERRUPT 10h - Function FEh 

GET SHADOW BUFFER 

Purpose: Determine the address of a virtual screen to use instead of the physical display memory. 
Available on: All machines. Restrictions: none. 

Registers at call: Return Registers: 

AH = FEh ES:DI - > actual video buffer for calling process 


ES:DI -> assumed video buffer (B800h:0000h 
color, B000h:0000h mono) 
Details: If no multitasker is installed, ES:D1 is returned unchanged. Top View requires a call to Function FFh to notify 
if that the screen has changed; DESQview will check for changes itself until the first call to Function FFh. 
See Also: Function FFh, INT 15h Function 10h Subfunction 24h, DESQview INT 21h Function 2Bh 


INTERRUPT 10h - Function FFh 
UPDATE SCREEN FROM SHADOW BUFFER 


Purpose: Indicate which portion of the virtual screen has been modified and needs to be updated on the physical dis- 


play. 

Available on: All machines. Restrictions: TopView or compatible must be 
running. 

Registers at call: Retirn Registers: n/a 

AH = FFh 


CX = number of consecutive changed characters 

ES:DI - first changed character in shadow buffer 

Details: Avoid CX=0000h, DESQview will discontinue the automatic screen updating initiated by Function FEh after 
this call. 

Conflicts: GO32 DOS Extender (chapter 9), Carbon Copy Plus (chapter 28). 
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See Also: Function FEh 
INTERRUPT 15h - Function 10h, Subfunction 00h 
"PAUSE" - GIVE UP CPU TIME 


Purpose: Indicate that the calling program is idle and that other programs may be given the remainder of the current 
time slice. 


Available on: All machines. Restrictions: TopView or compatible must be 
running. 

Registers at call: Return Registers: 

AX = 1000h return after other processes run 


Details: Under DESQview, if the process issuing this call has hooked INT O8h, the current time-slice is set to expire 
at the next clock tick rather than immediately. 

Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17), 

See Also: MultiDOS Function 00h (chapter 16), DoubleDOS INT 21h Function EEh (chapter 17), Windows INT 
2Fh Function 16h Subfunction 80h (chapter 14) 


INTERRUPT 15h - Function 10h, Subfunction 01h 
"GETMEM" - ALLOCATE "SYSTEM" MEMORY 


Purpose: Request a portion of the per-process pool of reserved memory. 


Available on: All machines. Restrictions: TopView or compatible must be 
running. 

Registers at call: Return Registers: 

AX=1001h ES:DI -> block of memory or 0000h:0000h (DV 

BX = number of bytes to allocate 2.26+) 


Details: Use SETERROR (DESQview Function DEh Subfunction 15h) to avoid a user prompt if there is insufficient 
system memory. 

Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17), 

See Also: Function 10h Subfunction 02h, DESQview Function DEh Subfunctions 0Ch and 15h 


INTERRUPT 15h - Function 10h, Subfunction 02h 
"PUTMEM" - DEALLOCATE "SYSTEM" MEMORY 


Purpose: Free a previously allocated block of the per-process pool of reserved memory. 


Available on: All machines. Restrictions: TopView or compatible must be 
running, 

Registers at call: Return Registers: 

AX = 1002h block freed 


ES:DI -> previously allocated block 
Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17). 
See Also: Function 10h Subfunction 01h, DESQview Function DEh Subfunction ODh 


INTERRUPT 15h - Function 10h, Subfunction 03h 
"PRINTC" - DISPLAY CHARACTER/ATTRIBUTE ON SCREEN 


Purpose: Output a single character with the specified attribute to the indicated window. 


Available on: All machines. Restrictions: TopView or compatible must be 
running. 

Registers at call: Return Registers: n/a 

AX = 1003h 


BH = attribute 

BL = character 

DX = segment of object handle for window 

Details: BX=0000h does not display anything, it only positions the hardware cursor. 
Conflicts: None known. 
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INTERRUPT 15h - Function 10h, Subfunction 13h 
"GETBIT" - DEFINE A 2ND-LEVEL INTERRUPT HANDLER 


Purpose: Specify a handler which will perform actions which a hardware interrupt handler is not allowed to perform 
under Top View or DESQview. 


Available on: All machines. Restrictions: TopView or compatible must be 
running. 

Registers at call: Return Registers: 

AX = 1013h BX = bit mask indicating which bit was allocated 

ES:DI -> FAR service routine 0000h if no more bits available 


Details: Only a few TopView/DESQview API calls are allowed during a hardware interrupt; if other calls need to be 
made, the interrupt handler must schedule a 2nd-level interrupt with "SETBIT" (Function 10h Subfunction 15h). 
Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17). 

See Also: Function 10h Subfunctions 14h and 15h 


INTERRUPT 15h - Function 10h, Subfunction 14h 
"EREEBIT" - UNDEFINE A 2ND-LEVEL INTERRUPT HANDLER 


Purpose: Release a previously defined handler so that another program may define a handler. 


Available on: All machines. Restrictions: TopView or compatible must be 
running, 

Registers at call: Return Registers: n/a 

AX = 1014h 


BX = bit mask from INT 15h Function 10h 

Subfunction [3h 
Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17). 
See Also: Function 10h Subfunctions 13h and 15h 


INTERRUPT 15h - Function 10h, Subfunction 15h 
"SETBIT" - SCHEDULE ONE OR MORE 2ND-LEVEL INTERRUPTS 


Purpose: Set a flag which requests that the indicated handlers should be invoked as soon as it is safe for them to 
make arbitrary API calls. 


Available on: All machines. Restrictions: TopView or compatible must be 
running. 

Registers at call: Return Registers: 

AX = 1015h indicated routines will be called: 

BX = bit mask for interrupts to post (DV 2.0x) at next task switch 


(DV 2.2x) immediately 
Details: This is one of the few TopView calls which are allowed from a hardware interrupt handler. The handler will 
be called with ES containing the segment of the handle of the next task to be executed; on return, ES must be the 
segment of a task handle. 
Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17). 
See Also: Function 10h Subfunctions 13h and 14h 


INTERRUPT 15h - Function 10h, Subfunction 16h 
"SOBu" - VERIFY OBJECT HANDLE 


Purpose: Determine whether the indicated value is a valid reference to a TopView or DESQview object. 


Available on: All machines. Restrictions: TopView or compatible must be 
running. 

Registers at call: Return Registers: 

AX = 1016h BX = FFFFh if ES:DI is a valid object handle 

ES:D1 = possible object handle 0000h if ES:DI is not 


Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17). 
See Also: DESQview Function DEh Subfunction [4h 
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INTERRUPT 15h - Function 10h, Subfunction 18h 
"LOCATE" - FIND WINDOW AT A GIVEN SCREEN LOCATION 


Purpose: Determine which window is visible at the specified location on the screen, or would be visible if the 
indicated window were moved. 


Available on: All machines. Restrictions: TopView or compatible must be 
running. 

Registers at call: Return Registers: 

AX = 1018h ES = segment of object handle for window which is 

BH =column visible at the indicated position, or covered by 

BL =row indicated window; 

ES = segment of object handle for window below = 0000h no window. 


which to search 
0000h = start search with topmost window 
Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17). 
See Also: Function 10h Subfunctions 23h and 24h 


INTERRUPT 15h - Function 10h, Subfunction 19h 
“SOUND” - MAKE TONE 


Purpose: Turn on the speaker at the specified frequency for the indicated duration. 


Available on: All machines. Restrictions: TopView or compatible must be 
running. 

Registers at call: Return Registers: 

AX = 1019h immediately, tone continues to completion 


BX = frequency in Hertz (0000h = silence) 

CX = duration in clock ticks (18.2 ticks/sec) 

Details: If another tone is already playing, the new tone does not start until completion of the previous one, Up to 32 
tones may be queued before the process is blocked until a note completes. In DV 2.00, the lowest tone allowed is 20 
Hz, If CX = 0, the current note is cancelled; if BX = 0 as well, all queued notes are also cancelled. 

Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17). 

See Also: FAKEY INT 16h Function 73h (chapter 36) 


INTERRUPT 15h - Function 10h, Subfunction 1Ah 
"OSTACK" - SWITCH TO TASK'S INTERNAL STACK 


Purpose: Change from the user's stack to a per-task private stack in preparation for making TopView API calls. 


Available on: All machines. Restrictions: TopView or compatible must be 
running, 

Registers at call: Return Registers: 

AX = 101Ah stack switched 


Details: This call may not be nested; a second call must be preceded by a call to "USTACK" (Function 10h 
Subfunction 25h). While TopView requires many API calls to be executed while on the task's internal stack, 
DESQview allows those calls to be executed regardless of the current stack. 

Conflicts: MultiDOS Plus (chapter 16), VMixX (chapter 17). 

See Also: Function 10h Subfunction 25h 


INTERRUPT 15h - Function 10h, Subfunction 1Bh 
"BEGINC" - BEGIN CRITICAL REGION 


Purpose: Indicate that the calling program is about to perform uninterruptible or nonreentrant operations and that 
task switching should be temporarily suspended, 


Available on: All machines. Restrictions: TopView or compatible must be 
Tunning, 
Registers at call: Return Registers: 


AX = I0IBh task-switching temporarily disabled 
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Details: Will not task-switch until "ENDC" (AX = 101Ch) called unless task voluntarily releases the CPU (upon 
regaining the CPU, task-switching will again be disabled). Suspends the caller until DOS is free, 

Conflicts: MultiDOS Plus (chapter 16), VMixX (chapter 17). 

See Also: Function 10h Subfunction 1Ch, DESQview Function DEh Subfunctions 13h and 1Ch, MultiDOS 
Function 0Dh (chapter 16), MS Windows INT 2Fh Function 16h Subfunction 81h (chapter 14) 


INTERRUPT 15h - Function 10h, Subfunction 1Ch 
"ENDC" - END CRITICAL REGION 


Purpose: Indicate that the program has completed its nonreentrant operations and that task switching may resume. 


Available on: All machines. Restrictions: TopView or compatible must be 
running. 

Registers at call: Return Registers: 

AX =101Ch Task-switching enabled 


Details: This API call may be made from within a hardware interrupt handler. 
Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17). 
See Also: Function 10h Subfunction 1Bh, DESQview Function DEh Subfunctions 13h and 1Bh, MS Windows INT 


2Fh Function 16h Subfunction 82h (chapter 14) 


INTERRUPT 15h - Function 10h, Subfunction 1Dh 
"STOP" - STOP TASK 


Purpose: Request that the indicated task not receive any more time slices until explicitly restarted. 


Available on: All machines. Restrictions: TopView or compatible must be 
running, 
Registers at call; Return Registers: 
AX =101Dh Indicated task will not get any CPU time until restarted 
ES = segment of object handle for task to be with Function 10h Subfunction [Eh 
stopped (== handle of main window for that 
task) 


Details: Once a task has been stopped, additional "STOP'"s are ignored. 

BUG: In DV 2.00, this function is ignored unless the indicated task is the current task. 
Conflicts: MultiDOS Plus (chapter 16), VMixX (chapter 17). 

See Also: Function 10h Subfunctions 1Eh and 2Bh, VMix Function 12h (chapter 17) 


INTERRUPT 15h - Function 10h, Subfunction 1Eh 
"START" » START TASK 


Purpose: Request that the indicated task be restarted and begin receiving time slices again, 


Available on; All machines. Restrictions: TopView or compatible must be 
running, 

Registers at call: Return Registers: 

AX = 101Eh Indicated task is started up again 


ES = segment of object handle for task to be started 
(== handle of main window for that task) 
Details: Once a task has been started, additional "START"s are ignored. 
Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17). 
See Also: Function 10h Subfunctions 1Dh and 2Bh 


INTERRUPT 15h - Function 10h, Subfunction 1Fh 
"DISPEROR" - POP-UP ERROR WINDOW 


Purpose: Display a standardized error window, and specify which actions the user may take to acknowledge it. 


Available on: All machines. Restrictions: TopView or compatible must be 
running. 
Registers at call: Return Registers: 


AX = 101Fh BX = status: 





| 
| 
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BX = bit fields 1 = left button, 
bits 0-12: number of characters to display 2=right, 
27 = ESC pressed 
bits 13,14: which mouse button may be pressed 
to remove window 
00 = either 
O1 = left 
10 = right 
11 = either 
bit 15: beep if 1 
DS:DI -> text of message 
CH = width of error window (0 = default) 
CL = height of error window (0 = default) 
DX = segment of object handle 
Details: The window remains on-screen until ESC or indicated mouse button is pressed. 
Conflicts: None known. 


INTERRUPT 15h - Function 10h, Subfunction 21h 
"PGMINT" « INTERRUPT ANOTHER TASK 


Purpose: Force another task to execute the specified subroutine regardless of what it is currently executing. 
Available on: All machines. Restrictions: TopView or compatible must be 
running. 

Registers at call: Return Registers: n/a 
AX = 1021h 
BX = segment of object handle for task to interrupt 

(not self) 
DX:CX -> FAR routine to jump to next time task is 

run 
Details: The FAR routine is entered with the current ES, DS, SI, DI, and BP values, using the task's internal stack 
(see Function 10h Subfunction 1Ah); only SS:SP needs to be preserved. Multiple PGMINTs to a single task are 
processed last-in first-out. If the other task is ina DOS or DV API call, the interruption will occur on return from that 
call, 
Conflicts: None known. 


INTERRUPT 15h - Function 10h, Subfunction 22h 
"GETVER" - GET VERSION 


Purpose: Determine whether TopView or a compatible is running, and if so the TopView version number. 


Available on: All machines. Restrictions: none. 

Registers at call: Return Registers: 

AX = 1022h BX nonzero if TopView or compatible loaded (BL = 
BX = 0000h major version, BH = minor version) 


Details: Task View returns BX = 0001h, DESQview 2.0+ returns BX = OAOIh 
Conflicts: None known. 


INTERRUPT 15h - Function 10h, Subfunction 23h 
"POSWIN” - POSITION WINDOW 


Purpose: Specify a new location for the indicated window, possibly in relation to another window on the screen. 


Available on: All machines. Restrictions: TopView or compatible must be 
running. 
Registers at call: Return Registers: n/a 


AX = 1023h 


i 
| 
i 
i 
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BX = segment of object handle for parent window 
within which to position the window (0 = full 
screen) 

ES = segment of object handle for window to be 
positioned 

DL = bit flags 
bits 0,1: horizontal position 

00 = current 
01 = center 
10 = left 
11 =right 
bits 2,3: vertical position 
00 = current 
Ol = center 
10 = top 
11 = bottom 
bit 4: don't redraw sereen if set 
bits 5-7 not used 

CH = number of columns to offset from position 
specified by DL 

CL = number of rows to offset from position 
specified by DL 

Conflicts: None known. 


INTERRUPT 15h - Function 10h, Subfunction 24h 
"GETBUF" « GET VIRTUAL SCREEN INFO 


Purpose: Determine the address, size, and type of the virtual screen buffer for the specified window. 


Available on: All machines. Restrictions: TopView or compatible must be 
running. 
Registers at call: Return Registers: 
AX = 1024h ES:DI -> virtual screen 
BX = segment of object handle for window (0 = use CX = size of virtual screen in bytes 
default) DL = 00h text screen 


Olh graphics screen 
Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17). 
See Also: INT 10h Function FEh 


INTERRUPT 15h - Function 10h, Subfunction 25h 
"USTACK" - SWITCH BACK TO USER'S STACK 


Purpose: Change back to the user stack after operating on the per-task private stack while making TopView API 
calls, 


Available on: All machines. Restrictions: TopView or compatible must be 
running. 

Registers at call: Return Registers: 

AX = 1025h stack switched back 


Details: Call only after having switched to internal stack with Function 10h Subfunction 1Ah, While TopView 
requires many API calls to be executed while on the task's private stack, DESQview allows those calls to be executed 
regardless of the current stack. 

Conflicts: MultiDOS Plus (chapter 16), VMixX (chapter 17). 

See Also: Function 10h Subfunction [Ah 
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INTERRUPT 15h - Function 10h, Subfunction 2Bh 
"POSTTASK" - AWAKEN TASK 


Purpose: Force a task which is waiting on its OBJECTQ to continue by placing the handle for the task on the 
OBJECTQ. 


Available on: All machines. Restrictions: DESQview version 2.00 or higher (or 
possibly TopView) must be running. 

Registers at call: Return Registers: n/a 

AX = 102Bh 


BX = segment of object handle for task 
Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17). 
See Also: Function 10h Subfunctions 1Dh and 1Eh 


INTERRUPT 15h - Function 10h, Subfunction 2Ch 
START NEW APPLICATION IN NEW PROCESS 


Purpose: Start up a new program as if the user had started it manually from the "Open Window” menu; this call is 
not limited to programs on that menu, however. 


Available on: All machines. Restrictions: DESQview version 2.00 or higher (or 
possibly TopView) must be running. 

Registers at call: Return Registers: 

AX = 102Ch BX = segment of object handle for new task 0000h on 

ES:DI -> contents of .PIF/ .DVP file (Table 15-1) error 


BX = size of .PIF/.DVP info 
Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17). 


Table 15-1. Format of .PIF/.DVP File: 


Offset Size Description 

00h WORD reserved (0) 

02h 30 BYTEs blank-padded program title 

20h WORD maximum memory to allocate to partition in K 
22h WORD minimum memory required in K 
24h 64BYTEs ASCIZ program pathname 

64h BYTE default drive letter (‘A’,...) 

65h 64 BYTEs ASCIZ default directory name 
A5h 64 BYTEs ASCIZ program parameters 

E5h BYTE initial screen mode (0-7) (see also offset 189h) 
E6h BYTE number of text pages used 

E7h BYTE number of first interrupt to save 
E8h BYTE number of last interrupt to save 
E9h BYTE rows in virtual screen buffer 
EAh BYTE columns in virtual screen buffer 
EBh BYTE initial window position, row 
ECh BYTE initial window position, column 
EDh WORD system memory in K 

EFh 64BYTEs ASCIZ shared program name 
12Fh 64BYTEs ASCIZ shared program data file 
16Fh BYTE flags1 


bit 7: writes text directly to screen 
bit 6; runs in foreground only 
bit 5: uses math coprocessor 
bit 4: accesses system keyboard buffer directly 
bits 3-1: reserved (0) 
bit 0: swappable 
170h BYTE flags2 
bit 6: uses command-line parameters in field at ASh 





| 
' 
| 
| 
j 
| 
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Table 15-1. Format of .PIF/.DVP File (continued) 


Offset Size Description 
bit 5: swaps interrupt vectors 


---information unique to .DVP files 





71h 2BYTEs keys to use on open menu 
73h WORD size of script buffer in bytes 
75h WORD automatically give up CPU after this many tests for keyboard input in one clock tick 
(default 0 = never) 
7™m BYTE nonzero = "uses own colors” 
78h BYTE nonzero if application swappable 
79h 3BYTEs _ reserved (0) 
7Ch BYTE nonzero to automatically close on exit 
7Dh BYTE nonzero if copy-protect floppy is required 
-~information unique to DESQview 2.0 and higher 
TEh BYTE -DVP version number 
00h DESQview 1.2+ 
O1h DESQview 2.0+ 
02h DESQview 2.2+ 
TFh BYTE reserved (0) 
80h BYTE initial number of rows in physical window 
8lh BYTE initial number of columns in physical window 
82h WORD maximum expanded memory to allow, in K 
84h BYTE flags3 





bit 7: automatically assign window position 

bit 5: maximum memory value has been specified 
bit 4: disallow "Close" command 

bit 3: foreground-only when doing graphics 

bit 2: don't virtualize 


185h BYTE keyboard conflict level (0-4 for DV<2.26, 00h-OFh for DV2.26+) 
186h BYTE number of graphics pages used 

187h WORD extra system memory size 

189h BYTE initial screen mode (FFh = default) (overrides offset ESh) 
---information unique to DESQview 2.2+ 

18Ah BYTE serial port usage 


FFh uses all serial ports 
00h no serial ports 
Oh only COM} 
02h only COM2 
18Bh BYTE flags4 
bit 7: automatically close application on exit if .COM or .EXE specified 
bit 6; swappable if not using serial ports 
bit 5: start program with window hidden (v2.26+) 
bit 4: start program in background (v2.26+) 
bit 3: virtualize text 
bit 2: virtualize graphics 
bit 1: share CPU when foreground 
bit 0: share EGA when foreground and zoomed 
18Ch BYTE protection level for 386 machines 
18Dh 19 BYTEs reserved (0) 


INTERRUPT 15h - Function 10h, Subfunction 2Dh 

"KMOUSE" - KEYBOARD MOUSE CONTROL 

Purpose: Determine whether the keyboard mouse emulation is currently on, or force the emulation on or off. 

Available on: Ali machines. Restrictions: DESQview version 2.00 or higher must 
be running. 
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Registers at call: Return Registers: 
AX =102Dh BL = 00h using real mouse 
BL = subfunction: Oth using keyboard mouse 


00h determine whether using keyboard mouse 
Olh turn keyboard mouse on 
02h turn keyboard mouse off 
Conflicts: MultiDOS Plus (chapter 16), WMiX (chapter 17). 


INTERRUPT 15h - Function 11h 


TopView commands 

Purpose: Additional TopView API calls; these are discussed under Function DEh in the DESQview section. 

Available on: All machines. Restrictions: TopView or compatible must be 
running. 

Registers at call: Return Registers: varies 

AH= 1th 


AL = various (except 17h) 

Details: In DESQview 2.x, subfunctions 00h through OAh are identical to the same-numbered subfunctions of 
Function DEh. 

Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17). 

See Also: DESQview Function DEh 


INTERRUPT 15h - Function 11h, Subfunction 17h 
"ASSERTMAP" - GET/SET MAPPING CONTEXT 


Purpose: Force a specified EMS mapping register set into activity, to ensure addressability of a particular program's 
code or data. 


Available on: All machines. Restrictions: DESQview version 2.20 or higher must 
be running. 
Registers at call; Return Registers: 
AX = 1117h BX = mapping context in effect before call 
BX=0000h get current mapping context without interrupts enabled 
setting 


nonzero —_— set new mapping context 
Details: Unlike all other subfunctions, this call differs from AX = DEL7h for DESQview v2.20 through 2.25. 
Mapping contexts determine conventional-memory addressability; setting a mapping context ensures that the 
associated program and data areas are in memory for access. Usable by drivers, TSRs and shared programs. Caller 
need not be running under DESQview, but must ensure that the stack in use will not be mapped out by the call. 
Conflicts; MultiDOS Plus (chapter 16), VMiX (chapter 17). 
See Also: DESQview Function DEh Subfunction 17h, MS Windows INT 2Fh Function 16h Subfunction 85h 
(chapter 14) 


INTERRUPT 15h - Function 12h, Subfunction 00h 
SEND MESSAGE "HANDLE" - RETURN OBJECT HANDLE 


Purpose: Determine the handle of the specified object. 


Available on: All machines. Restrictions: TopView or compatible must be 
running. 

Registers at call: 

AH = 12h 

BH = 00h Return Registers: 


DWORD on top of stack is object handle 
BL = which handle to return 
00h handle in DWORD on top of stack 
Olh current task's window handle 


02h given task's mailbox handle (task’s handle 
on stack) 
03h current task's mailbox handle 
04h given task's keyboard handle (task's handle 
on stack) 
05h current task's keyboard object handle 
06h given task's OBJECTQ handle (task’s 
handle on stack) 
O7h current task’s OBJECTQ handle 
O8h \ 
thru > return 0000:0000 under DV prior to 
10h / 2.26 
OCh (DESQview 2.26+) task owning object 
with handle in DWORD on top of stack 
ODh (DESQview 2.26+) task handle of owner 
(parent) of current task 
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Details: BL=0Ch,0Dh returns 00000000h if the object is not open (keyboard, mailbox, panel, pointer, and timer 


objects) or is an orphan (task, window). 


Conflicts; MultiDOS Plus (chapter £6), VMiX (chapter 17). 
INTERRUPT 15h - Function 12h, Subfunction 01h 


SEND MESSAGE "NEW". CREATE NEW OBJECT 


Purpose: Allocate resources for a new object of the specified type, and return a handle by which it may be 


referenced, 
Available on: All machines. 


Registers at call: 
AH = 12h 
BH =01h 
BL = object type to create 
00h (DV 2.0x only) handle is DWORD on top 
of stack 
Oh (DV 2.0x only) use task's window handle 
02h (DV 2.0x only) given task's mailbox (task's 
handle on stack) 
03h (DV 2.0x only) current task's mailbox 
04h (DV 2.0x only) given task's keyboard 
(task’s handle on stack) 
05h (DV 2.0x only) current task’s keyboard 
object 
08h WINDOW class 
09h MAILBOX class 
OAh KEYBOARD class 
OBh TIMER object (counts down 32-bit time in 
10ms increments) 
OFh POINTER object 
10h PANEL object 
STACK: (if window object or WINDOW class) 
DWORD address to jump to (no new task if 
high word == 0) 
DWORD (reserved) 
0 = non-task window, 
FFFFh = task window 


Restrictions: TopView or compatible must be 
running. 

Return Registers: 

DWORD on top of stack is new object handle 

all input stack arguments have been popped 
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DWORD bytes for task’s private stack 
(FFFFh == default of 0100h) 

DWORD bytes system memory for input buffer 

for READ/READN (0 == none, -1 == 
default--same as logical window size) 

DWORD window size, columns 

DWORD window size, rows 

DWORD length of window title 

DWORD address of window title 
Details: If a new task is created, it is started with: 

AX =BX =SI=Di=BP=0 
DX:CX = handle of parent task 
DS = ES = SS = segment of private stack (and new task’s handle) 

New windows are orphans, inherit the colors/hidden status of the creating task's window, and are placed in the 
upper left hand comer of the screen but not automatically redrawn, New keyboards are closed, and have all object 
bits cleared except for the hardware cursor bit. 

Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17), 
See Also: Function 12h Subfunction 02h 


INTERRUPT 15h - Function 12h, Subfunction 02h 
SEND MESSAGE "FREE” - FREE AN OBJECT 


Purpose: Release the specified objects and the resources it is using. 


Available on: All machines. Restrictions: TopView or compatible must be 
running, 

Registers at call; Return Registers: n/a 

AH = 12h 

BH = 02h 

BL = object 


00h handle in DWORD on top of stack 
window: close window and free 
timer: free timer 
panel: free panel object 
pointer: free pointer 
Oth task's window handle - kills task, never 
returns 
02h given task's mailbox (task's handle on top 
of stack) 
03h current task’s mailbox 
04h given task's keyboard (task’s handle on top 
of stack) 
OSh current task’s keyboard object 
Details: When a window is freed, its keyboard and pointer objects are freed; task windows also free any mailbox, 
objectq, and pane! objects held by the task and any child tasks, If the keyboard being freed is the default keyboard for 
a task, this call is equivalent to CLOSE. Panel and pointer objects are automatically closed if open. 
Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17). 
See Also: Function 12h Subfunction 01h, Function 12h Subfunction ODh 


INTERRUPT 15h - Function 12h, Subfunction 03h 
SEND MESSAGE "ADDR" - GET HANDLE OF MESSAGE SENDER 


Purpose: Determine which task sent the last message read from the given mailbox. 
Available on: All machines. Restrictions: TopView or compatible must be 
running. 
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Registers at call: Return Registers: 

AH = 12h DWORD on stack is task handle of message sender 
BH = 03h 

BL = object 


00h mailbox handle in DWORD on top of stack 
02h sender of last msg read from mailbox 
(task's handle on stack) 
03h sender of last msg read from current task’s 
mailbox 
Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17). 
See Also: Function 12h Subfunction 00h 


INTERRUPT 15h - Function 12h, Subfunction 03h 
SEND MESSAGE "CONNECT" » CONNECT TWO WINDOWS 


Purpose: Attach the specified window to another so that both will always move in unison. 


Available on: All machines. Restrictions: DESQview version 2.26 or higher must 
be running. 

Registers at call: Return Registers: 

AH = [2h STACK arguments popped 

BH = 03h 


BL = window to be connected 
00h handle of window to be attached is in 
DWORD on top of the stack 
Olh attach current task's main window 
STACK: DWORD handle of attaching window (if 
passed on stack) 
DWORD handle of window to attach to or 
00000000h to detach 
Details: Multiple windows may be attached to a single window, but cach window may only be attached to one 
window at a time, 
Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17). 


INTERRUPT 15h - Function 12h, Subfunction 03h 
SEND MESSAGE "DIR" - GET PANEL FILE DIRECTORY 


Purpose: Determine the names and locations of the panels contained in a panel file (Table 15-2). 


Available on: All machines. Restrictions: TopView or compatible must be 
running. 

Registers at call: Return Registers: 

AH = 12h STACK: DWORD length of directory (always multiple 

BX = 0300h of 14 bytes) 

STACK: DWORD handle of panel object DWORD address of directory 


Details: A null string is returned if the object is not open. 
Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17). 


Table 15-2, Format of TopView panel file: 


Offset Size Description 

00h 2BYTEs CO0hC3h 

02h BYTE number of panels in file 
03h for each panel in file: 


8BYTEs _ blank-padded panel name 
DWORD panel offset in file 
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Table 15-2. Format of TopView Panel File (continued) 


Offset Size Description 
WORD panel length 
data for panels (each consists of one or more window/query/manager streams). First byte 
of each pane] must be 1Bh, fifth byte must be E5h 


INTERRUPT 15h - Function 12h, Subfunction 04h 
SEND MESSAGE "READ" - READ NEXT LOGICAL LINE OF WINDOW 


Purpose: Retrieve a line's worth of characters or attributes from the specified window. 


Available on: All machines. Restrictions: TopView or compatible must be 
running. 

Registers at call: Return Registers: 

AH=12h STACK: DWORD number of bytes read 

BH = 04h DWORD address of buffer 


BL = window to read from 
00h handle is DWORD on top of stack 
Olh use calling task's default window 
OCh (DV 2.26+) default window of task owning 
handle on top of stack 
ODh (DV 2.26+) default window of parent task 
of current task 
Details: Reading starts at the current logical cursor position; the cursor is updated to point at the character following 
the last one read. Any translucent blanks (FFh) which are visible on screen are changed to the character which is seen 
through them. The string produced by the read is placed in an input buffer which may be reused by the next READ 
or READN of a window. Window stream opcodes D8h and D9h determine whether the read returns characters or 
attributes. 
Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17). 
See Also: Function 12h Subfunctions 05h and 12h 


INTERRUPT 15h - Function 12h, Subfunction 04h 
SEND MESSAGE "READ" - GET NEXT RECORD FROM OBJECT 


Purpose: Get the next unit of input from the specified object; the unit returned depends upon the type of the object. 


Available on: All machines. Restrictions: TopView or compatible must be 
running. 
Registers at call: Return Registers; 
AH = 12h STACK: (if objectq) DWORD handle of object with 
BH = 04h input 
BL = object (otherwise) DWORD number of bytes 
00h handle is DWORD on top of stack DWORD address 


mailbox: wait for and get next message 
keyboard: wait for and get pointer to next input 
buffer 
pointer: wait for and get 
next message 
02h get next message from mailbox (task’s handle 
on top of stack) 
03h get next message from current task's mailbox 
04h get the next input from keyboard (handle on 
top of stack) 
O5h get the next input from task's default 
keyboard 


TopView and DESQview/QEMM 15-15 


06h wait for input from any object in 
OBJECTQ (handle on stack) 
07h wait for input from any object in task's 
default OBJECTQ 
Details: For a keyboard in keystroke mode, the input buffer is a single byte containing the character code as returned 


by the BIOS; the BIOS scan code is available via the STATUS call if the character is zero. For a keyboard in field 
mode, the input buffer format is determined by the field table header for the window to which the keyboard is 
attached. Keyboard input buffers and mailbox message buffers may be invalidated by the next READ, ERASE, 
CLOSE, or FREE message to the same object. 

Conflicts: MultiDOS Plus (chapter 16), WMiX (chapter 17). 

See Also: Function 12h Subfunction 05h 


Table 15-3. Format of pointer message: 


Offset Size Description 
00h WORD row 

02h WORD column 
04h BYTE status 


bit 6: set when press/release mode active and button released 

bits 7-2: number of clicks-I if multiple-click mode active 

bits 1,0: button pressed (00=none,01=button I ,10=button2) 
05h BYTE field number or zero (APILEVEL >= 2.00 only) 


INTERRUPT 15h - Function 12h, Subfunction 04h 
SEND MESSAGE "READ" » WAIT FOR TIMER TO EXPIRE 


Purpose: Suspend calling program until the expiration of the specified timer object. 


Available on: All machines. Restrictions: TopView or compatible must be 
running. 

Registers at call: Return Registers: 

AH = 12h after timer expires 

BX = 0400h STACK: DWORD time in 1/100 sec after midnight 

STACK: DWORD timer's handle when timer expired 


Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17). 


INTERRUPT 15h - Function 12h, Subfunction 04h 
SEND MESSAGE "APPLY" - WRITE PANEI TO WINDOW 


Purpose: Display all of the fields of the specified panel to the indicated window, then create an object which may be 
read to retrieve the user's input if the panel defines any input fields. 


Available on: All machines. Restrictions: TopView or compatible must be 
running. 

Registers at call: Return Registers: 

AH = 12h STACK: DWORD handle of keyboard or 0 

BX = 0400h DWORD handle of window which was used 


STACK: DWORD handle of panel object 
DWORD window's handle (or 0 for current 
task's window) 
DWORD length of panel name 
DWORD pointer to panel name 
Details: The status of the APPLY may be checked with the STATUS message. The panel MUST have the following 
format: 

first byte must be 1Bh (i.e. must start with a stream) 

the first opcode in the stream must be E5h 

single byte arg of opcode is interpreted thus: 
bits 7,6 11 means create new window 
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10 means create new field table for existing window 
01 means use existing window and field table 
bit 5 if set, panel contains a field table (creates a new keyboard and puts it in field mode) 


bit 4 if set, panel contains input fields 


bit 3 if set, panel contains select fields but no input fields 
If the panel contains input or select fields, a keyboard handle is returned; either the window's current open 
keyboard or a newly-created keyboard object. The caller should read that keyboard to obtain input from the panel. 


Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17). 
INTERRUPT 15h - Function 12h, Subfunction 05h 


SEND MESSAGE "WRITE" - WRITE TO OBJECT 


Purpose: Send information to the specified object; the action taken is dependent upon the type of object, 


Available on: All machines. 


Registers at call; 


AH = 12h 
BH =05h 
BL = object 


00h handle is DWORD on top of stack 
timer: start timer to end at a specified time 
keyboard: add input buffer to queue 
pointer: move pointer icon to specified 
position 
02h send message by value/ status = 0 to mbox 
(task's handle on stack) 
03h send message by value/ status = 0 to current 
task's mailbox 
04h add input buffer to KEYBOARD queue 
(handle on top of stack) 
05h add input buffer to task’s default 
KEYBOARD queue 
O6h add an object to OBJECTQ (handle on top 
of stack) 
07h add an object to task's default OBJECTQ 
STACK: 
(if mailbox) 
DWORD length 
DWORD address 
(if keyboard) 
DWORD status (scan code in keystroke mode) 
DWORD length (should be | in keystroke 
mode) 
DWORD address 
(if objectq) 
DWORD handle of object to add 
(if timer) 
DWORD 1/100ths seconds since midnight 
(actually only accurate to 1/18 sec) 
(if pointer) 
DWORD column relative to origin of window 
DWORD row relative to origin of window 


Restrictions; TopView or compatible must be 
running, 

Return Registers: 

STACK arguments popped 

CF set on error 


Details: Under DESQview version 2.20 or higher, failed mailbox writes may return CF set (see Function DEh 
Subfunction 15h) rather than aborting the calling program. The data and status written to a keyboard object must 
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match the format returned by the keyboard object in the current mode. The pointer position is scaled according to the 


current scaling factors. 
Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17). 
See Also: Function 12h Subfunction 04h 


INTERRUPT 15h - Function 12h, Subfunction 05h 
SEND MESSAGE "WRITE" » WRITE STRING TO WINDOW 


Purpose: Output the specified string, which may contain TopView/DESQview control sequences. 


Available on: All machines. Restrictions: TopView or compatible must be 
running. 

Registers at call: Return Registers: 

AH = 12h indicated actions performed 

BH = 05h 


BL = window to write to 
00h DWORD on top of stack is window handle 
Olh write string to task's default window 
OCh (DV 2.26+) default window of task owning 
handle on top of the stack 
ODh (DV 2.26+) default window of parent of 
current task 


STACK: DWORD object handle if handle passed STACK: DWORD handle of new window if the string 
on stack contains a window stream (see below) with 
DWORD total length of string (high word == 0) opcode E6h 
DWORD address of string to display else nothing 


Details: Non-control characters are displayed (opcodes DEh and DFh control whether the attributes are left as is or 
changed to the current attribute); CR/LF/BS/Tab cause the usual cursor movement; and ESC starts a data structure 
with additional commands if the following byte is less than 20h; otherwise, the ESC character is written to the 


window 
Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17). 


Table 15-4, Format of TopView Data Structure: 


MAGIC DB 1Bh 

MODE DB ? ; 00h, 01h, 10h, [4h-1Fh legal 

LENGTH DW ? ; length of remainder in bytes 

var-length fields follow, each an OPCODE followed by 
zero or more args 

MODE 00h (set or display values) "WINDOW STREAM" 
Opcodes:argumenis 

00h display 20h blanks with the default attribute 

O1h-IFh display OPCODE blanks with the default attribute 

20h display char with default attribute 20h times 
BYTE char to repeat 

21h-3Fh display char with default attribute OPCODE-20h times 
BYTE char to repeat 

40h display 20h blanks with specified attribute 
BYTE attribute of blanks 

41h-5Fh display OPCODE-40h blanks with specified attribute 
BYTE attribute of blanks 

60h display next 20h characters 
20h BYTEs characters to display 

61h-7Fh display next OPCODE-60h characters 
N BYTEs characters to display 


| 
i 
| 
| 
| 
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Table 15-4, Format of TopView Data Structure (continued) 


80h-87h display N blanks with default attribute 
BYTE low 8 bits of 11-bit count (high 3 in low 3 bits of OPCODE) 
000h means 800h 
88h-8Fh display N copies of the character 
BYTE low 8 bits of 11-bit count (high 3 in low 3 bits of OPCODE) 
000h means 800h 
BYTE character to repeat 
90h-97h display N blanks with specified attribute 
BYTE low 8 bits of 11-bit length (high 3 in low 3 bits of OPCODE) 
000h means 800h 
BYTE attribute 
98h-9FH display string at logical cursor pos 
BYTE low 8 bits of 11-bit length (high 3 in low 3 bits of OPCODE) 
000h means 800h 
N BYTEs string to display 
AOh set logical cursor row 
BYTE row number (0 is top) 
Ath set logical cursor column 
BYTE column number (0 is leftmost) 
A2h set top edge of scrolling region 
BYTE row 
A3h set left edge of scrolling region 
BYTE column 
A4h_ set row of physical window position 
BYTE line 
ASh set column of physical window position 
BYTE column 
AGh set height of physical window 
BYTE #rows 
A7h set width of physical window 
BYTE #columns 
A8h set viewport row 
BYTE row 
A9Qh set viewport column 
BYTE column 
AAh set virtual screen height [contents of window unpredictable after] 
BYTE rows 
ABh set virtual screen width [contents of window unpredictable after] 
BYTE columns 
ACh-AEh unused 
AFh set compatible/preferred video modes 
BYTE compatibility/preference mask 




















bit 7 compatible with monochrome 

bit 6 compatible with color text, EGA/VGA graphics 
bit 5 compatible with medium-resolution CGA graphics 
bit 4 compatible with high-resolution CGA graphics 

bit 3 prefer monochrome 

bit 2 prefer color text, EGA/VGA graphics 

bit 1 prefer medium-resolution CGA graphics 


bit 0 prefer high-resolution CGA graphics 
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| 
| 
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Table 15-4, Format of TopView Data Structure (continued) 


BOh move logical cursor down 
BYTE #rows (signed, negative values move up) 
[if #rows=0 and hardware cursor owner, update hw crsr] 
Blh move logical cursor right 
BYTE 4cols (signed, negative values move left) 
[if #cols=0 and hardware cursor owner, update hw crst’] 
B2h shift top edge of scrolling region 
BYTE #rows (signed) 
B3h shift left edge of scrolling region 
BYTE #cols (signed) 
B4h shift physical window down 
BYTE #lines (signed) 
B5h shift physical window right 
BYTE #columns (signed) 
B6h expand physical window vertically 
BYTE #lines (signed) 
B7h expand physical window horizontally 
BYTE #columns (signed) 
B8h adjust viewport row 
BYTE #rows (signed) 
i B9h adjust viewport column 
| BYTE #columns (signed) 
| BAh adjust virtual screen height [contents of window unpredictable after] 
i BYTE #rows to increase (signed) 
| BBh adjust virtual screen width [contents of window unpredictable after] 
| BYTE #cols to increase (signed) 
BCh-BFh reserved (currently unused) 
COh set logical cursor position 
BYTE row number (0 is top border) 
BYTE column number (0 is left border) 
Clh set top left corner of scrolling region 
BYTE row 
BYTE column 
C2h set physical window pos 
BYTE upper left row (no top border if 0) 
BYTE upper left column (no left border if 0) 
C3h set current window size 
BYTE #rows 
BYTE #cols 
C4h_ set upper left corner of viewport (portion of virtual screen 
displayed in window) 
BYTE row 
BYTE column 
C5h set size of virtual screen [contents unpredictable afterwards] 
BYTE #rows 
BYTE #cols 
C6h unused 
C7h unused 
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Table 15-4. Format of TopView Data Structure (continued) 


C8h set logical cursor relative to current position 
BYTE number of rows to move down (signed) 
BYTE number of columns to move right (signed) 
[if #rows=#cols=0 and hardware cursor owner, update hw cursr] 
C9h shift top left corner of scrolling region 
BYTE #rows (signed) 
BYTE #cols (signed) 
CAh set window pos relative to current position 
BYTE number of rows to shift down (signed) 
BYTE number of columns to shift right (signed) 
CBh set window size relative to current size 
BYTE number of rows to expand (signed) 
BYTE number of cols to expand (signed) 
CCh shift viewport relative to current position 
BYTE rows to shift (signed) 
BYTE cols to shift (signed) 
CDh resize virtual screen 
BYTE #rows to expand (signed) 
BYTE #cols to expand (signed) 
CEh scroll text when using E8h-EBh/F8h-FBh opcodes (default) 
CFh scroll attributes when using E8h-EBh/F8h-FBh opcodes 
DOh allow window frame to extend beyond screen 
Dth always display a complete frame, even if window extends beyond 
edge of screen 
D2h allow DV to change logical colors on video mode switch (default) 
D3h application changes logical attributes 
D4h window is visible [must redraw to actually make visible] 
DSh_ window is hidden [must redraw to actually remove] 
D6h window has frame (default) 
D7h window unframed [must redraw to actually remove frame] 
D8h READ/READN will read characters from window (default) 
D9h READ/READN will read attributes from window 
DAh use logical attributes, which may be remapped attributes 
1 normal text 
2 highlighted normal text 
3 help text 
4 highlighted help text 
5 error message 
6 highlighted error message 
7 emphasized text 
8 marked text 
9-16 are reverse video versions of 1-8 
DBh use physical attributes for characters 
DCh enable special actions for control characters (default) 
DDh disable special control char handling, all chars displayable by 
BIOS TTY cail 
DEh write both character and attribute (default) 
DFh write character only, leave attribute untouched 
E0h repeat following commands through E1h opcode 
BYTE number of times to repeat (00h means 256 times) 
Elh end of commands to repeat, start repeating them 
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Table 15-4. Format of TopView Data Structure (continued) 


E2h set current output color 
BYTE color 
83h clear virtual screen from scroll origin to end using current color 
E4h redraw window 
E5h select menu style 
BYTE style (normally 18h) 
bits 5,4 =O1 use two-letter menu entries for remainder of this stream 
E5h (panel file only) 
BYTE modifier 
bits 7,6 = 11 panel stream creates new window 
= 10 panel defines new field table for existing window 
= 01 panel stream uses existing window & field table 
bit 5 = | stream contains a field table (create kyboard object) 
bit 4 = 1 stream defines input fields (create keyboard object) 
bit 3 = 1 stream defines select fields but not input fields 
bit 2 = 1 stream defines exclusive input window (DV 2.2) 
bit | reserved 
bit 0 reserved 
E6h create new window and perform rest of manipulations in new window 
BYTE number of rows 
BYTE number of columns 
Return: DWORD object handle of new window returned on stack at end 
E7h no operation 
E8h scroll area up (top left corner defined by opcode Cih) 
BYTE height 
BYTE width 
E9h scroll area down (top left corner defined by opcode C1h) 
BYTE height 
BYTE widt 
EAh scroll area left (top left corner defined by opcode C1h) 
BYTE height 
BYTE width 
EBh scroll area right (top left corner defined by opcode C1h) 
BYTE height 
BYTE width 
ECh set logical attributes for window contents 
BYTE video modes command applies to 





bit 7 monochrome 
bit 6 color text, EGA/VGA graphics 
bit 5 medium-resolution CGA graphics 


it 4 high-resolution CGA graphics 
BYTE which attributes to set 
bit 7 if set, copy single following byte to indicated attributes 
bits 4-6 # of first attribute to change - 1 
bits 0-3 # of consecutive attributes to change 
N BYTEs new attributes 
EDh set logical attributes for window frame 
BYTE video modes command applies to (see opcode ECh) 
BYTE which attributes to set 
it 7 if set, copy single following byte to indicated attributes 
bits 4-6 # of first attribute to change - 1 
its 0-3 # of consecutive attributes to change 





} 
i 
| 
i 
i 
i 
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Table 15-4. Format of TopView Data Structure (continued) 


N BYTEs new attributes 
attributes 
1 = top left corner 
2 = top right corner 
3 = bottom left corner 
4 = bottom right comer 
5 = top edge 
6 = bottom edge 
7 = left edge 
8 = right edge 
EEh set characters for window frame 
BYTE video modes command applies to (see opcode ECh) 
BYTE which characters to set 
bit 7 if set, copy single following byte to indicated chars 
bits 4-6 # of first char to change - 1 
bits 0-3 # of consecutive chars to change 
N BYTEs new chars (same relative position as attributes above) 
EFh set window name 
BYTE length of name (should be in range 0 to logical screen width) 
N BYTEs name 
FOh clear input field to blanks 
BYTE field number 
Fih fill input field with character 
BYTE field number 
BYTE char 
F2h set color of input field 
BYTE field number (1-N) 
BYTE attribute 
F3h set initial contents of input field 
BYTE field number (1-N) 
N BYTEs enough chars to exactly fill field as defined by op FFh 
F4h position cursor to start of specific input field 
BYTE field number (1-N) 
F5h change field table entry 
BYTE field number 
7-8 BYTEs field table entry (see opcode FFh below) 
F6h set field type 
BYTE field number 
BYTE type 
00h inactive 
40h output field 
80h input field 
COh deselected field 
C2h selected field 
F7h “broadcast write” write data to fields with program output bit set 
in field table entry, in field number order 
N BYTEs (total length of all program output fields) 
F8h scroll field up a line 
BYTE field number 
F9h scroll field down a line 
BYTE field number 
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Table 15-4. Format of TopView Data Structure (continued) 


FAh scroll field left 
BYTE field number 
FBh scroll field right 
BYTE field number 
FCh set field table header 
BYTE number of fields (must be <= existing number of fields) 
BYTE screen behavior bits 
bit 7 reserved 
bit 6 set if menu items may be selected via keyboard 
bit 5 set if left mouse button may terminate entry 
bit 4 set if right mouse button may terminate entry 
bit 3 if set, select fields return contents or blanks rather than 'Y’ or 'N' 
bit 2 if set, modified bits reset on return to application 
bits 0,1 = 00 no data returned on read of keyboard 
O1 data returned as array of chars containing all fields packed together, with no field 
numbers 
10 data returned as numbered variable-length records for all fields 
11 data returned as numbered variable-length records for the fields which were 
modified 
BYTE current input field (updated by DESQview) 
BYTE current select field (updated by DESQview) 
BYTE attribute for select fields when they are pointed at 
BYTE attribute for select fields which have been selected 
FDh reset modified bit for all fields 
FEh reset selected and moditied bits for all fields 
FFh set up input fields 
6 BYTEs field table header (see opcode FCh above) 
the field table entries, one for each field 
BYTE start row \ 
BYTE start column \if menu selection and start is to 
BYTE end row / right or below end, select from kbd only 
BYTE end column / 
BYTE field type 
bits 7,6 = 00 inactive (non-entry) field 
01 echos keystrokes input to make menu selection 
10 fill-in field 
11 select field 
bit 5 field can be filled by broadcast write (F7h opcode) 
bit 4 reserved 
bit 3 reserved 
bit 2 reserved 
bit 1 set if field selected 
bit 0 set if field modified 
BYTE modifier 
if type is fill-in, then bit flags to determine behavior 
bit 7 if set, automatically enter CR when field full 
bit 6 move to next field when current field is full 
bit 5 if set, enter text from right end (for numbers) 
bit 4 if set, force input to uppercase 
bit 3. if set, clear old contents on first keystroke 


i 
i 
| 
} 
| 
| 
| 
| 
| 
i 
| 
| 
| 
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Table 15-4. Format of TopView Data Structure (continued) 


bit 2 if set, input returned when cursor moves out of modified field (API level 2.02+) 
bit 1 reserved 
bit 0 reserved 
if select field, first key to press to activate 
00h if have to point-&-click or is an extended-ASCI keystroke (only if two-key 
menus enabled) 
BYTE (select field only) normal color of field 
BYTE second key for select field. This byte is present if two-letter menu entries selected with 
opcode ESh, and in that case is present regardless of field type 
Note: DESQview uses and updates the actual copy of the information which is contained in the stream. 
Thus this info must remain intact until after the data entry is complete. 


MODE Oth "QUERY STREAM’ (valid only for those opcodes listed here) 


AOh return logical cursor row in next byte 
Alh return logical cursor column in next byte 
A2h return top row of scrolling region in next byte 
A3h return left column of scrolling region in next byte 
A4h return row of physical window origin in next byte 
A5Sh return column of physical window origin in next byte 
A6h return height of physcial window in next byte 
A7h return width of physical window in next byte 
A8h return row of viewport origin in next byte 
AQh return column of viewport origin in next byte 
AAh return height of virtual screen in next byte 
ABh return width of virtual screen in next byte 
AFh return current video mode in next byte 
COh return current logical cursor position in next two bytes 
Cih return top left corner of scrolling region in next two bytes 
C2h return current window position in next two bytes 
C3h return current window size in next two bytes 
C4h return current viewport origin in next two bytes 
C5Sh return current virtual screen size in next two bytes 
DOh\ overwritten with DOh if frames may fall off screen edge 
Dih/ Dith if frames always displayed entirely 
D2h\ overwritten with D2h if DESQview controls color palette 
D3h / D3h if application changes color palette 
D4h\ overwritten with D4h if window visible 
D5h/ D5h if window hidden 
D6h\ overwritten with Déh if window has frame 
D7h/ D7h if window unframed 
D8&h\ overwritten with D8h if reading characters from window 
D9h/ D9h if reading attributes from window 
DAh \ overwritten with DAh if using logical attributes 
DBh / DBh if using physical attributes 
DCh\ overwritten with DCh if TTY control char interpretation on 
DDh/ DDh if TTY control char interpretation off 
DEh \ overwritten with DEh if writing both characters and attributes 
DFh / DFh if leaving attributes untouched 
E2h return current color in next byte 
ECh get logical attributes for window contents 
BYTE execute call if currently in specified video mode 
bit 7 monochrome 
bit 6 color text, EGA/VGA graphics 
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Table 15-4, Format of TopView Data Structure (continued) 


bit 5 medium-resolution CGA graphics 
bit 4 high-resolution CGA graphics 
BYTE which attributes to get 
bit 7 unused 
bits 4-6 first attribute to get - 1 
bits 0-3 # consecutive attributes 
N BYTEs buffer to hold attributes 
EDh get logical attributes for window frame 
BYTE execute call if currently in video mode (see opcode ECh) 
BYTE which attributes to get 
bit 7 unused 
bits 4-6 first attribute to get - 1 
bits 0-3 # consecutive attributes 
N BYTEs buffer to hold attributes 
EEh get characters for window frame 
BYTE execute call if currently in video mode (see opcode ECh) 
BYTE which attributes to get 
bit 7 unused 
bits 4-6 first char to get - f 
bits 0-3 # consecutive chars 
N BYTEs buffer to hold chars 
EFh return first N characters of current window name 
BYTE max length of returned name 
N BYTEs buffer to hold window name 
F3h return contents of specified field 
BYTE field number 
N BYTEs buffer to hold field contents (size exactly equal to field 
size) 
F5h get field table entry 
BYTE field number 
7-8 BYTEs buffer to hold field table entry 
Notes: DV < 2.26 always returns 7 bytes 
DV 2.26+ w/ APILEVEL < 2.26 returns 8 bytes if and only if field 
table is using 8-byte entries and eighth byte after 
F5h is E7h (NOP); otherwise, 7 bytes are returned 
DV 2.26+ w/ APILEVEL > 2.26 returns 7 or 8 bytes 
depending on the field table entry size 
F6h get type of a field 
BYTE field number 
BYTE type 
FCh get field table header 
6 BYTEs buffer to store header 


MODE 10h "MANAGER STREAM" (valid only for opcodes listed here) 
00h allow window to be moved horizontally 
O1h allow window to be moved vertically 
02h allow window to change width 
03h allow window to change height 
04h allow window to be scrolled horizontally 
O5h allow window to be scrolled vertically 
06h allow "Close Window" menu selection for application 
07h allow "Hide Window" menu selection for application 
08h allow application to be suspended (“Rearrange/Freeze") 
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Table 15-4. Format of TopView Data Structure (continued) 


OEh allow "Scissors" menu 
Oh allow DESQview main menu to be popped up 
Th allow "Switch Windows" menu 
2h allow "Open Window" menu 
3h allow "Quit" menu selection 
20h-33h opposite of OOh-13h, disallow specified action 
40h notify if horizontal position of window changes 
41h notify if vertical position of window changes 
42h notify if width of window changes 
43h notify if height of window changes 
44h notify if window scrolled horizontally 
45h notify if window scrolled vertically 
46h notify if window is closed--program has to clean up and exit itself 
47h notify if window is hidden 
48h notify if "?" on main menu selected 
49h notify if pointer message sent to window 
4Ah notify if window is placed in foreground 
4Bh notify if window is placed in background 
4Ch notify if video mode changes 
4Dh notify if "Scissors" menu "Cut" option selected 
4Eh notify if "Scissors" menu "Copy" option selected 
4Fh notify if “Scissors” menu "Paste" option selected 
50h notify if DESQview main menu about to pop up 
51h notify if DESQview main menu popped down 
60h-71h opposite of 40h-51h: don't notify on specified event 
84h attach window to parent task's window (both move together) 
85h detach window from parent task's window (may move independently) 
86h disable background operation for application 
87h enable running in background 
88h set minimum size of physical window 
BYTE rows 
BYTE columns 
89h set maximum size of physical window 
BYTE rows 
BYTE cols 
8Ah set primary asynchronous notification routine 
DWORD address of routine, 0000h:0000h means none (see also below) 
8Bh set asynchronous notification parameter 
DWORD 32-bit value passed to 8Ah async routine in DS:SI 
ACh (DV2.2+) perform regular select field attribute processing 
ADh (DV2.2+) protect attributes in selected field from being lost 
AEh make window default notify window for owning app (API level 2.00+) 
AFh set selected field marker character 
BYTE character to display at left edge of selected fields 
BCh set standard field processing mode 
BDh set alternate field processing mode (enables cursor pad for menus) 
BEh disables changing reverse logical attributes with ECh opcode 
BFh enables changing reverse logical attributes with ECh opcode 
COh make current window topmost in system 
Clh force current process into foreground 
C2h make current window topmost in process 
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Table 15-4, Format of TopView Data Structure (continued) i 
C3h position mouse pointer relative to origin of current field 
BYTE rows below upper left corner of field i 
BYTE columns to right of upper left corner of field 
i C4h position mouse pointer relative to origin of given field 
| BYTE field number 
| BYTE rows below upper left corner of field 
BYTE columns to right of upper left corner of field 
CS5h orphan current window (also hides it) 
Note: must be last in stream; all subsequent commands ignored 
C6h show all windows for this process 
C7h hide all windows for this process 
C8h suspend process and hide all its windows 
C9h force current process into background 
CAh make current window bottom-most in process 
CBh cancel current window manager operation, remove DV menu, give 
control to topmost application 
CCh orphan window and give it to the system for use as paste data 
CEh reorder windows 
DWORD pointer to null-terminated list of words; each word is the segment of the object handle for a 
window 
FFh no operation 


MODES 14h to 1Fh "USER STREAMS" 
normally NOPs, but may be defined by SETESC message to invoke FAR 
routines, one for each mode number 
on entry to handler, 
DS:SI -> first byte of actual stream (not header) 
CX = #bytes in stream 
ES:DI = window's handle 


| 
Asynchronous notification routine defined by manager stream 8An is called with: 




















i 
| 
| 


ES:DI = handle of window 
DS:SI is 32-bit value set by 8Bh manager stream opcode 
mailbox contains message indicating event 
Opeode Arguments (if any) 
40h horizontal movement 
DWORD object handle of window 
BYTE new row 
BYTE new co 
i 4ih vertical movement 
DWORD object handle of window 
BYTE new row 
BYTE new co 
42h horizontal size change 

DWORD object handle of window ! 
BYTE new rows | 
| BYTE new cols \ 
| 43h vertical size change | 
a 
| 
] 
\ 
i 


DWORD object handle of window 
BYTE new rows 
BYTE new cols 





| 44h scrolled horizontally | 
| DWORD object handle of window | 
i BYTE mouse row within window 
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Table 15-4. Format of TopView Data Structure (continued) 


BYTE mouse column within window 
BYTE field mouse is on, 0 if none 
BYTE amount moved: >0 right, <0 left, 0 done 
45h scrolled vertically 
DWORD object hande of window 
BYTE mouse row within window 
BYTE mouse column within window 
BYTE field mouse is on, 0 if none 
BYTE amount moved: >0 down, <0 up, 0 done 
46h window close request 
DWORD object handle of window 
BYTE mouse pointer row 
BYTE mouse pointer column 
BYTE field mouse is on, 0 if none 
47h application's windows hidden 
48h Help for Program selected 
DWORD object handle of window 
BYTE mouse pointer row 
BYTE mouse pointer column 
BYTE field mouse is on, 0 if none 
49h pointer message sent to window 
DWORD pointer handle which received message 
4Ah switched to window from another ("raise") 
4Bh switched away from the window (“lower”) 
4Ch video mode changed 
BYTE new BIOS video mode 
4Dh Scissors/cUt selected 
DWORD object handle of window 
BYTE row of upper left corner 
BYTE column of upper left corner 
BYTE field number ul corner is in, O=none 
DWORD handle of orphaned window created with 
copy of data from specified region 
BYTE height of region 
BYTE width of region 
4Eh Scissors/Copy selected 
DWORD object handle of window 
BYTE row of upper left corner 
BYTE column of upper left corner 
BYTE field number ul corner is in, 0=none 
DWORD handle of orphaned window created with 
copy of data from specified region 
BYTE height of region 
BYTE width of region 
4Fh Scissors/Paste selected 
DWORD object handle of window 
BYTE row of upper left corner 
BYTE column of upper left corner 
BYTE field number ul corner is in, O=none 
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Table 15-4. Format of TopView Data Structure (continued) 
DWORD handle of orphaned window with data 
BYTE height of region 
BYTE width of region 
Note: the orphaned data window should be 
adopted or freed when done 
50h main menu about to pop up 
51h main menu popped down 


Return Registers: 
all registers unchanged 


INTERRUPT 15h - Function 12h, Subfunction 06h 
SEND MESSAGE “SETPRI" - SET PRIORITY WITHIN OBJECTQ 


Purpose: Specify the relative order in which events for the given object will be retrieved from the task's OBJECTQ, 
Higher-priority objects will receive attention first even if a lower-priority object is already waiting for attention. 


Available on: All machines. Restrictions: DESQview version 2.20 or higher must 
be running. 

Registers at call: Return Registers: 

AH= 12h all registers unchanged, 

BH = 06h STACK arguments popped 

BL = object 


00h object handle is in DWORD on top of stack 
(mailbox, keyboard, pointer, or timer) 

04h given task's keyboard (task's handle on top 
of stack) 

OSh current task's default keyboard 

STACK: DWORD object handle if passed on 


top of 
stack 
DWORD new priority of object in task's 
OBJECTQ 


Details: Initially all objects have the same default value. The program should only make relative adjustments to this 
default value, as the default value is not guaranteed to be constant from version to version. When changing priorities, 
all objects already on the objectq are reordered. 

Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17). 

See Also: Function 12h Subfunction 07h 


INTERRUPT 15h - Function 12h, Subfunction 07h 
SEND MESSAGE "GETPRI" » GET PRIORITY WITHIN OBJECTQ 


Purpose: Determine the relative order in which events for the given object will be retrieved from the task’s 


OBJECTQ. 
Available on: All machines, Restrictions: DESQview version 2.20 or higher must 
be running. 


1 
| 
i 
i 
| 
j 
| 
| 
| 
| 
\ 
| 
H 
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Registers at call: Return Registers: 

AH = 12h STACK: DWORD object priority 
BH =07h 

BL = object 


00h object handle in DWORD on top of stack 
mailbox, keyboard, pointer, or timer 
04h given task’s keyboard (task's handle on top 
of stack) 
O5h current task’s default keyboard 
Details: Initially all objects have the same default value. The program should only make relative adjustments to this 
default value, as the default value is not guaranteed to be constant from version to version. 
Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17). 
See Also: Function 12h Subfunction 06h 


INTERRUPT 15h - Function 12h, Subfunction 08h 
SEND MESSAGE "SIZEOF" - GET OBJECT SIZE 


Purpose: Determine the logical size of an object; the units in which the size is measured depend on the type of the 

object. 

Available on: All machines. Restrictions; TopView or compatible must be 
running, 

Return Registers: 

DWORD on top of stack is result 


Registers at call: 
AH = 12h 
BH = 08h 
BL = object 
00h handle in DWORD on top of stack 
window: total character positions in window 
timer: elapsed time since timer started 
pointer: number of messages queued to 
pointer object 
panel: number of panels in panel file 
keyboard: number of input buffers queued 
Oth total chars in current task's default window 
02h number of messages in task's mailbox 
(task's handle on stack) 
03h number of messages in current task's 
mailbox 
04h number of input buffers queued in task's 
kbd (handle on stack) 
OSh number of input buffers queued for current 
task's default kbd 
06h number of objects queued in OBJECTQ 
(task's handle on stack) 
07h number of objects queued in current task's 
OBJECTQ 
OCh (DV 2.26+) total chars in window owning 
handle on top of stack 
ODh (DV 2.26+) total chars in parent task’s 
window 
Details: For panel objects, a count of zero is returned if no panel file is open for the object. 
Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17). 
See Also: Function 12h Subfunctions 04h and 09h 
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INTERRUPT 15h - Function 12h, Subfunction 09h 
SEND MESSAGE "LEN" - GET OBJECT LENGTH 


Purpose: Determine the length of a window's line or the length of time remaining on a timer object, 


Available on: All machines. Restrictions: TopView or compatible must be 
running. 

Registers at call: Return Registers: 

AH = 12h DWORD on top of stack is length 

BH = 09h 

BL = object 


00h handle in DWORD on top of stack 
window: get chars/line 
timer: get 1/100 seconds remaining before timer 
expires 
Olh get number of chars/line in current task's 
default window 
OCh (DV 2.26+) get chars/line in window owning 
handle on top of stk 
ODh (DV 2.26+) get chars/line in parent task's 
window 
Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17). 
See Also: Function 12h Subfunction 08h 


INTERRUPT 15h - Function 12h, Subfunction OAh 
SEND MESSAGE "ADDTO" - WRITE CHARACTERS AND ATTRIBUTES TO WINDOW 


Purpose: Output matched strings of characters and attributes as a single stream of alternating characters and 
attributes to the specified window. 


Available on: All machines. Restrictions: TopView or compatible must be 
running. 

Registers at call: Return Registers: 

AH = 12h STACK arguments popped 

BH =0Ah 


BL = window to write to 
00h window handle is DWORD on top of stack 
Olh current task's default window 
OCh (DV 2.26+) default window of task owning 
handle on top of stack 
ODh (DV 2.26+) default window of parent of 
current task 
STACK: DWORD window/task handle if 
passed on top of stack 
DWORD count of attributes 
DWORD address of attribute string 
DWORD count of characters 
DWORD address of character string 
Details: If one string is longer than the other, the shorter one will be reused until the longer one is exhausted. The 
cursor is left just after the last character written. 
Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17). 
See Also: Function 12h Subfunction OBh 





| 
| 
| 
| 
\ 


15-32 TopView and DESQview/QEMM 


INTERRUPT 15h - Function 12h, Subfunction OAh 
SEND MESSAGE "ADDTO" - SEND MAILBOX MESSAGE/STATUS BY VALUE 


Purpose: Store a message and associated status byte in the specified mailbox by making an actual copy of the 
message in a system-internal buffer, 


Available on: All machines. Restrictions: TopView or compatible must be 
running. 

Registers at call: Return Registers: 

AH= 12h STACK arguments popped 

BH = 0Ah CF set on error 


BL = mailbox to write to 
00h handle is DWORD on top of stack 
02h default mailbox of task whose handle is on 
top of stack 
03h current task's default mailbox 
STACK: DWORD mailbox/task handle if 
passed on 
top of stack 
DWORD status (in low byte) 
DWORD length of message 
DWORD address of message 
Details: The message is copied into either system or common memory. Insufficient memory normally causes the 
process to be aborted; under DESQview 2.2+, failed writes may return CF set instead (see Function DEBh Subfunction 
15h). 
Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17). 
See Also: Function 12h Subfunction OBh 


INTERRUPT 15h - Function 12h, Subfunction OAh 
SEND MESSAGE "ADDTO" - SET OBJECT BITS 


Purpose: Turn on the specified control flags for the indicated object; the meaning of the flag bits depends on the 


type of the object. 

Available on: All machines, Restrictions: TopView or compatible must be 
running. 

Registers at call: Return Registers: 

AH = 12h STACK argument popped 

BH =0Ah 

BL = object 


00h handle is DWORD on top of stack 
timer: start timer for specified interval 
pointer: set control flags (Table 15-5) 
keyboard: set control flags (Table 15-6) 
04h set control flags on KEYBOARD object 
(handle on top of stack) 
O5h set control flags on task's default 
KEYBOARD object 
STACK: 
(if timer) 
DWORD duration in 1/100 seconds 
(otherwise) 
DWORD bits to set 
Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17). 
See Also: Function 12h Subfunction OBh 
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Table 15-5. Pointer Objects, Bit Significance: 


Bit Significance 

TS reserved, can't be set 

14-8 unused 

7 mouse pointer is hidden while in window 


6 get messages even if window not topmost 

5 get messages even if window not foreground 

4 multiple clicks separated by less than 1/3 second are counted and returned in a single message 

3 pointer position is relative to screen origin, not window origin 

2 send message on button release as well as button press 

1 (DV 2.23+) send message with row=FFFFh and col=FFFFh whenever pointer leaves the window 

0 send message only on button activity, not movement (DV-specific, and Function DEh Subfunction OFh 
must have been called first) 


Table 15-6. Keyboard Objects, Bit Significance: 


Bit Significance 

15 reserved, can't be set 

14 unused 

13 reserved, can't be set 

12-6 unused 

5 (DV 2.24) exclusive input 

4 filter all keys (used with handler established by SETESC) 
if 0, only keys that would normally be 
displayed are filtered 

3 program continues executing while input in progress 

2 insert mode active for field mode 

1 hardware cursor displayed when task is hardware cursor owner 


must be set if keyboard in field mode 
and field table includes input fields 
0 keyboard is in field mode rather than keystroke mode 


INTERRUPT 15h - Function 12h, Subfunction OBh 
SEND MESSAGE "SUBFROM" - WRITE ATTRIBUTES TO WINDOW 


Purpose: Output a string of display attributes to the specified window, preserving the characters currently in the 
locations where the attributes are written. 


Available on: All machines. Restrictions: TopView or compatible must be 
running. 

Registers at call: Return Registers: 

AH = 12h STACK arguments popped 

BH =0Bh 


BL = window to write attributes to 
00h handle is DWORD on top of stack (pushed 
after other parameters) 
Oh current task's default window 
OCh (DV 2.26+) default window of task owning 
handle on top of stack 
ODh (DV 2.26+) default window of parent of 
current task 
STACK: DWORD number of attributes to write 
DWORD address of attributes 
Details: The specified attributes are written starting at the current cursor position; the cursor is left just after the last 
position written. 
Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17). 
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See Also: Function 12h Subfunction 0Ah 
INTERRUPT 15h - Function 12h, Subfunction 0Bh 


SEND MESSAGE "SUBFROM" - SEND MAILBOX MESSAGE/STATUS BY REFERENCE 


Purpose: Store a message and associated status byte in the specified mailbox, only placing a pointer to the message 
in the mailbox rather than the actual message. 


Available on: All machines. Restrictions: TopView or compatible must be 
running. 

Registers at call: Return Registers: 

AH = 12h STACK arguments popped 

BH = 0Bh CF set on error 


BL = mailbox to write to 

00h handle is DWORD on top of stack 

02h default mailbox of task whose handle is on 

top of stack 

03h current task's default mailbox 
STACK: DWORD status (low byte) 

DWORD length of message 

DWORD address of message 
Details: Even though only a pointer to the message is stored, the write may still fail due to insufficient memory. 
Under DV 2.2+, failed mailbox writes may return CF set (see Function DEh Subfunction 15h); prior versions always 
terminated the program. 
Conflicts: MultiDOS Plus (chapter 16), VMixX (chapter 17). 
See Also: Function 12h Subfunction OAh 


INTERRUPT 15h - Function 12h, Subfunction 0Bh 
SEND MESSAGE "SUBFROM” - REMOVE OBJECT FROM OBJECTQ 


Purpose: Indicate that an object no longer needs attention, either because it has been serviced or because it no longer 
exists. 


Available on: All machines. Restrictions: TopView or compatible must be 
running. 

Registers at call: Return Registers: 

AH = 12h STACK arguments popped 

BH=0Bh 


BL = OBJECTQ from which to remove all copies of 
a particular object 
06h OBJECTQ of task whose handle is on top 
of the stack 
07h task's default OBJECTQ 
STACK: DWORD task handle if passed on stack 
DWORD handle of object to remove 
Details: This message should be sent whenever an object is erased or closed, so that a subsequent read of the 
OBJECTQ does not return an object handle which no longer requires attention. 
Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17). 


INTERRUPT 15h - Function 12h, Subfunction 0Bh 
SEND MESSAGE "SUBFROM" - RESET OBJECT BITS 


Purpose: Tur off the specified control flags for the indicated object; the meaning of the flag bits depends on the 


type of the object. 

Available on: All machines. Restrictions: TopView or compatible must be 
running. 

Registers at call: Return Registers: 


AH= 12h STACK arguments popped 
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BH = 0Bh 
BL = object 
00h handle is DWORD on top of stack 
pointer: reset control flags 
keyboard: reset control flags 
04h clear control flags on KEYBOARD object 
(handle on top of stack) 
05h clear control flags on task's default 
KEYBOARD object 
STACK: DWORD object handle if passed on top of 
the stack 
DWORD which bits to clear (see Function 12h 
Subfunction 0Ah "SET OBJECT BITS" 
above) B 
Details: The attributes are written starting at the current cursor position; the cursor is left just after the last position 
written. 
Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17). 
See Also: Function 12h Subfunction OAh 


INTERRUPT 15h - Function 12h, Subfunction 0Ch 
SEND MESSAGE "OPEN" - OPEN OBJECT 


Purpose: Prepare of J/O or other manipulation of the specified object. 


Available on: All machines, Restrictions: TopView or compatible must be 
running. 

Registers at call: Return Registers: 

AH = 12h STACK arguments popped 

BH =0Ch 

BL = object 


00h handle is DWORD on top of stack 

window: fill with given character from 
scroll origin to end 

keyboard: attach to a window 
timer: open 
pointer: start taking input for window 
panel: associate with a panel file 

OJh fill task's default window with given char 
from scrl org to end 

02h open given task's mailbox for input (task's 
handle on stack) 

03h open current task’s mailbox 

04h attach a KEYBOARD to a window (handle 
on top of stack) 

05h attach task's default KEYBOARD to a 
window 


06h open a task's OBJECTQ (task's handle on 
top of stack) 

07h open current task's OBJECTQ 

0Ch (DV 2.26+) fill def window of task owning 
handle on top of stck 

ODh (DV 2.26-) fill default window of parent 
of current task 
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STACK: 
(if window) 

DWORD character to fill with 
(if keyboard or pointer) 

DWORD handle of window to attach to 
(if panel) 

DWORD length of filename or resident panel 

DWORD address of filename or resident panel 
(otherwise) 

nothing 
Details: If first byte of panel file name is 1Bh, then the "name" IS a panel. If first two bytes of panel file "name" are 
COhC3h, then the "name" IS the panel file. Result code of open may be retrieved with STATUS message. Logical 
cursor is left at scroll origin after filling window. The task opening a mailbox becomes its owner, and the only task 
allowed to read the mailbox. Messages are only sent to a pointer object when the mouse is positioned in the window 
to which the pointer has been attached, There is no need to explicitly open a timer object, as ADDTO and WRITE 
messages automatically open the timer. 
Conflicts; MultiDOS Plus (chapter 16), VMiX (chapter 17). 
See Also: Function 12h Subfunctions ODh and 14h 


INTERRUPT 15h - Function 12h, Subfunction 0Dh 
SEND MESSAGE "CLOSE" - CLOSE OBJECT 


Purpose: Indicate that the specified object no longer needs to be manipulated. 


Ayailable on: All machines. Restrictions: TopView or compatible must be 
running. 

Registers at call: Return Registers: n/a 

AH = 12h 

BH =0Dh 

BL = object 


00h handle is DWORD on top of stack 
timer: close 
keyboard: detach from window and discard 
queued input 
pointer: stop taking input 
panel; close 
mailbox: close, unlock, and discard any 
pending messages 
02h close given task's mailbox (task's handle on 
top of stack) 
03h close task's default mailbox 
04h close KEYBOARD object (handle on top of 
stack) 
05h close task's default KEYBOARD 
OGh close given task's OBJECTQ (task's handle 
on top of stack) 
07h close current task's OBJECTQ 
Details: When an OBJECTQ is closed, each object in the OBJECTQ is sent an ERASE message (Function 12h 
Subfunction 0Eh). When a panel object is closed, the panel file and any panels currently in use are freed; window 
and keyboard objects created by APPLY are not affected, but field mode input ceases. Open but idle timer objects 
consume a small amount of CPU time. 
Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17). 
See Also: Function 12h Subfunctions OCh, OEh, and 14h 
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INTERRUPT 15h - Function 12h, Subfunction 0Eh 
SEND MESSAGE "ERASE" - ERASE OBJECT 


Purpose: Discard all pending I/O for the object, or otherwise clear it; the action taken depends upon the type of the 


object. 

Available on: All machines. Restrictions: TopView or compatible must be 
. running. 

Registers at call: Return Registers: n/a 

AH= 12h 

BH = 0Eh 

BL = object 


00h handle is DWORD on top of stack 
window: clear from scroll origin to end of 
window 
keyboard: discard input timer: cancel 
current interval 
pointer: discard all pending messages 
mailbox: discard all pending messages 
Olh clear task's default window from scroll 
origin to end 
02h discard all queued messages in mailbox 
(handle on top of stack) 
03h discard all queued messages in current 
task's default mailbox 
04h discard all input queued to KEYBOARD 
(handle on top of stack) 
05h discard all input queued to task’s default 
KEYBOARD 
06h remove all objects from OBJECTQ (task's 
handle on top of stack) 
07h remove all objects from current task's 
OBJECTQ 
OCh (DV 2,26+) clear window of task owning 
handle on top of stack 
ODh (DV 2,26+) clear default window of parent 
of current task 
Details: When an OBJECTQ is erased, each object in the OBJECTQ is also erased, 
Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17). 
See Also: Function 12h Subfunction 02h 


INTERRUPT 15h - Function 12h, Subfunction OFh 
SEND MESSAGE "STATUS" - GET OBJECT STATUS 


Purpose: Determine the current state of the specified object. 


Available on: All machines. Restrictions; TopView or compatible must be 
tunning. 

Registers at call: Return Registers: 

AH = 12h DWORD on top of stack is status 

BH = 0OFh 

BL = object 


00h handie is DWORD on top of stack 
timer: is it running? 
pointer: return status of last message 
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panel: verify success of last OPEN or 
APPLY 
02h return status of last msg READ from 
mailbox (handle on stack) 
03h return status of last msg READ from task's 
default mailbox 
04h get status of last msg from task's 
KEYBOARD (task handle on stk) 
OSh get status of last msg from task's default 
KEYBOARD 
Oh return whether OBJECTQ is open or not 
(handle on top of stack) 
07h return whether task's default OBJECTQ is 
open or not 
Details: If object is a panel object, the status indicates the error code: 
00h successful 
14h panel name not in panel directory 
15h not enough memory to apply panel 
16h invalid panel format 
17h panel file already open 





81h-92h DOS error codes+80h \ codes > 80h indicate 
95h not enough memory to open panel file > that the panel was 
98h null panel file name / not opened 


Tf object is a timer, the status is: 
00000000h open but not running 
40000000h open and running 
80000000h closed 
If object is an OBJECTQ, the status is: 
00000000h open 
80000000h closed 
If object is a keyboard in keystroke mode, the status is the extended character code (scan code) of the last 
keystroke 
If object is a keyboard in field mode, the status indicates the reason for the last retum from the field manager: 
00h Enter key pressed 
Oh Button | or keystroke selection 
02h Button 2 i 
03h validation i 
04h auto Enter on field i 
1Bh Escape pressed | 
46h “Break pressed i 
other: extended code for key terminating input 
The status of mailbox messages sent by the window manager is always 80h. The status of a pointer message is 
the same as the status field in the message. 
Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17). 
See Also: Function 12h Subfunction 04h 


INTERRUPT 15h - Function 12h, Subfunction 10h 
SEND MESSAGE "EOF" - GET OBJECT EOF STATUS 


Purpose: Determine whether the end of the specified object's contents has been reached, 


Available on: All machines. Restrictions: TopView or compatible must be 
running. 

Registers at call: Return Registers: 

AH=12h DWORD on top of stack is status 


BH = 10h 
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BL = object 
00h handle is DWORD on top of stack 
window: return TRUE if logical cursor past 
end of window 
mailbox: unknown 
Olh returns TRUE if logical cursor past end of 
task's def window 
02h return EOF for task’s mailbox (task’s handle 
on top of stack) 
03h return EOF for current task's mailbox 
OCh (DV 2.26+) check logical cursor of window 
owning handle on top of stack 
ODh (DV 2.26+) check logical cursor of window 
of parent task 
Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17). 


INTERRUPT 15h - Function 12h, Subfunction 11h 
SEND MESSAGE "AT" - POSITION OBJECT CURSOR 


Purpose: Specify the logical cursor position for the indicated window. 


Available on: All machines. Restrictions: TopView or compatible must be 
running, 

Registers at call: Return Registers: 

AH = 12h STACK arguments popped 

BH= 11h 


BL = window for which to move cursor 
00h window's handle is DWORD on top of 
stack 
Olh task's default window 
OCh (DV 2.26+) default window of task owning 
handle on top of stack 
ODh (DV 2.26+) default window of parent of 
current task 
STACK: DWORD column 
DWORD row 
Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17). 


INTERRUPT 15h - Function 12h, Subfunction 11h 
SEND MESSAGE "'SETNAME" - ASSIGN NAME TO MAILBOX 


Purpose: Specify a globally-visible string with which the indicated mailbox object may be found by tasks who do 
not know the mailbox's object handle. 


Available on: All machines. Restrictions: TopView or compatible must be 
running. 
Registers at call: Return Registers: 
AH = 12h STACK arguments popped 
BH= 11h 


BL = mailbox to name 
00h DWORD on top of stack is mailbox 
handle 
02h use given task's mailbox (task's handle 
on top of the stack) 
03h use current task’s default mailbox 
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STACK: DWORD object handle if passed on top of 
the stack 
DWORD length of name 
DWORD address of name 
Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17). 
See Also: Function DEh Subfunction 0Eh 


INTERRUPT 15h - Function 12h, Subfunction 11h 
SEND MESSAGE "SETSCALE" - SET POINTER SCALE FACTOR 


Purpose: Specify the correspondence between positions in a window and the positions reported by or written to 


pointer objects. 
Available on: All machines. Restrictions: TopView or compatible must be 
running. 
Registers at call: Return Registers: 
AH = 12h STACK arguments popped 
BX = 1100h 
STACK: DWORD object handle for pointer 
object 


DWORD number of colums to scale pointer 
position to 
DWORD number of rows to scale pointer 
position to 
Details: Pointer positions will be scaled as if the window had the specified number of rows and columns; thus, 
reported positions may not be contiguous or multiple rows/columns may report the same value, depending on the 
scaling factors. 
Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17). 
See Also: Function 12h Subfunction 12h 


INTERRUPT 15h - Function 12h, Subfunction 12h 
SEND MESSAGE "READN" - GET NEXT N OBJECT BYTES 


Purpose: Retrieve the specified number of characters or display attributes from the indicated window. 


Available on: All machines. Restrictions: TopView or compatible must be 
running, 

Registers at call: Return Registers: 

AH = 12h STACK: DWORD width of screen line 

BH= 12h DWORD address 

BL = window to read from DWORD count actually read 


00h handle is DWORD on top of stack 
O1h read next N chars or attributes on task's 
default window 
OCh (DV 2.26+) read window of task owning 
handle on top of stack 
ODh (DV 2.26+) read default window of parent 
of current task 
STACK: DWORD count 
Details: Reading starts at the current logical cursor position; the cursor is updated to point at the character following 
the last one read. Any translucent blanks (FFh) which are visible on screen are changed to the character which is seen 
through them. The string produced by the read is placed in an input buffer which may be reused by the next READ 
or READN of a window, Window stream opcodes D8h and D9h determine whether the read returns characters or 
attributes, 
Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17), 
See Also: Function 12h Subfunctions 04h and 05h for windows 
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INTERRUPT 15h - Function 12h, Subfunction 12h 
SEND MESSAGE "GETSCALE” - GET POINTER SCALE FACTOR 


Purpose: Determine the correspondence between positions in a window and the positions reported by or written to 
pointer objects. 


Available on: All machines. Restrictions: TopView or compatible must be 
running, 

Registers at call: Return Registers: 

AH = 12h STACK: DWORD pointer pos scaled as if window 

BX = 1200h were this many colums wide 


STACK: DWORD object handle for pointer DWORD pointer pos scaled as if window were this 
many rows high 
Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17). 


See Also: Function 12h Subfunction 11h 


INTERRUPT 15h - Function 12h, Subfunction 13h 

SEND MESSAGE "REDRAW" - REDRAW WINDOW 

Purpose: Force an immediate update of the physical screen to reflect any changes made to the specified window. 
Most modifications to a window do not become visible until the window is redrawn. 


Available on: All machines. Restrictions: TopView or compatible must be 
running, 

Registers at call: Return Registers: n/a 

AH = 12h 

BH = 13h 


BL = window object 
00h DWORD on top of stack is handle for 
window to redraw 
Oth redraw task's default window 
OCh (DV 2.26+) redraw window of task owning 
handle on top of stack 
ODh (DV 2.26+) redraw default window of 
parent of current task 
Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17). 
See Also: Function 12h Subfunction OEh 


INTERRUPT 15h - Function 12h, Subfunction 13h 
SEND MESSAGE "SETICON" - SPECIFY POINTER ICON 


Purpose: Specify the character which should be used to indicate the current position of the mouse pointer. 


Available on: All machines. Restrictions: TopView or compatible must be 
running. 

Registers at call: Return Registers: 

AH = 12h STACK arguments popped 

BX = 1300h 


STACK: DWORD object handle for pointer 

DWORD character to use for pointer 
Details: DESQview accepts but ignores this call; its pointer icon is always a diamond (screen character 4), 
Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17). 


INTERRUPT 15h - Function 12h, Subfunction 14h 

SEND MESSAGE "SETESC" - SET ESCAPE ROUTINE ADDRESS 

Purpose: Specify a handler for intercepting keyboard input or user stream output. 

Available on: All machines. Restrictions: TopView or compatible must be 
running. 
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Registers at call: Return Registers: 
AH=12h STACK arguments popped 
BH= 14h 


BL = message modifier 
00h handle is DWORD on top of stack 
Olh define user stream 
04h intercept keystrokes from KEYBOARD to 
a window (handle on stack) 
05h intercept keystrokes from task's default 
KEYBOARD to a window 
STACK: 
(Gif window) 
DWORD user stream number (14h-1Fh) 
DWORD address of FAR user stream handler 
(if keyboard) 
DWORD address of FAR filter function 
Details: The filter function is not allowed to make INT 15h, DOS, or BIOS calls, 
The keyboard filter function is called with the following when the keyboard is in field mode: 
AL = character 
AH = 00h or extended ASCII code if AL = 00h 
BL = field number 
CH = cursor column 
CL = cursor row 
DL = field type modifier (sixth item in field table entry) 
DH = seventh item in field table entry 
ES:SI = window's handle 
DS:DI -> field table entry for field containing the cursor 
The filter function should return 
AH = 00h use keystroke 
Olh ignore keystroke 
FFh beep and ignore keystroke 
Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17). 
See Also: Function 12h Subfunction 05h 


INTERRUPT 15h - Function 12h, Subfunction 14h 
SEND MESSAGE "LOCK" - REQUEST EXCLUSIVE ACCESS TO RESOURCE 


Purpose: Attempt to become the sole task allowed to use a resource which may not be accessed by multiple tasks 
simultaneously. 


Available on: All machines. Restrictions: TopView or compatible must be 
running. 

Registers at call: Return Registers: n/a 

AH= 12h 

BH = 14h 

BL = object 


00h mailbox handle is DWORD on top of stack 
02h use given task’s mailbox (task’s handle on 
top of stack) 

03h use current task's default mailbox 
Details: If some other task has already locked the mailbox, the caller is suspended until the mailbox becomes 
unlocked, Release exclusive access by sending a CLOSE message to the mailbox. A single task may request a lock 
multiple times, which then requires multiple CLOSEs. 
Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17). 
See Also: Function 12h Subfunction ODh 
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INTERRUPT 15h - Function 12h, Subfunction 15h 
SEND MESSAGE "SETFLAGS” - SET OBJECT FLAGS 


Purpose: Specify new values for an object's attributes; the meaning of the flag bits depends on the type of the object. 
Available on: All machines. Restrictions: DESQview version 2.20 or higher must 


be running. 
Registers at call: Return Registers: 
AH = 12h STACK arguments popped 
BH = 15h 
BL = object 


00h DWORD on top of stack (mailbox, 
keyboard, or pointer only) 
02h mailbox for task whose handle is on top of 
stack 
03h mailbox for current task 
04h keyboard for task whose handle is on top of 
stack 
05h keyboard for current task 
STACK: DWORD flags 
if mailbox: 
bit 0: all mail messages stored in common 
memory 
bit 1; allow write even if closed 
bit 2: don't erase messages when mailbox is 
closed 
if keyboard: 
bit 5: exclusive input when keyboard is in 
use for input 
Details: This function is only available if the API level has been set to at least 2.20, It is equivalent to performing 
SUBFROM and ADDTO calls on the object. 
Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17). 
See Also: Function 12h Subfunctions 0Ah, OBh, and 16h 


INTERRUPT 15h - Function 12h, Subfunction 16h 
SEND MESSAGE "GETFLAGS" - GET OBJECT FLAGS 


Purpose: Determine the current attributes of the specified object; the meaning of the flag bits depends on the type of 


the object. 

Available on: All machines. Restrictions: DESQview version 2.20 or higher must 
be running. : 

Registers at call: Return Registers: 

AH = 12h STACK: DWORD current control flags 

BH = 16h 

BL = object 


00h DWORD on top of stack (mailbox, keyboard, 
or pointer only) 
02h mailbox for task whose handle is on top of 
stack 
03h mailbox for current task 
04h keyboard for task whose handle is on top of 
stack 
05h keyboard for current task 
Details: This function is only available if the API level has been set to at least 2,20. 
Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17). 
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See Also: Function 12h Subfunctions OAh, OBh, and 15h 
DESQview 


As mentioned at the beginning of the chapter, the DESQview API is for the most part a superset of the TopView 
API. Subfunctions 00h through OAh of INT 15h Function DEh correspond exactly to the TopView subfunctions of 
INT 15h Function 11h, Some additional DESQview-specific calls are listed above in the TopView section because 
they fit in more logically there. 


INTERRUPT 15h - Function 11h, Subfunction DEh 
XDV.COM INSTALLATION CHECK 


Purpose: Determine whether DESQview was loaded using XDV. 


Available on: All machines. Restrictions; DESQview must be running and must 
have been loaded with XDV. 

Registers at call: Return Registers: 

AX = ]1DEh CF clear if installed 


AX = segment at which XDV is located 
Conflicts: MultiDOS Plus (chapter 16), VMiX (chapter 17). 


INTERRUPT 15h - Function DEh, Subfunction 00h 


GET PROGRAM NAME 

Purpose: Determine the offset of the calling program's name within the DESQview program list file. 
Available on: All machines. Restrictions: DESQview must be running. 
Registers at call: Return Registers: 

AX = DE00h AX = offset into DESQVIEW.DVO of current 


program's record (see below) 
Conflicts: None known. 
See Also: Function DEh Subfunction 07h 


Table 15-7, Format of Program Entry in DESQVIEW.DVO: 


Offset Size Description 
00h BYTE length of name 
Olh NBYTEs name 


2BYTEs _ keys to invoke program (second = 00h if only one key used) 
WORD apparently always 0000h 
BYTE end flag: 00h for all but last entry, which is FFh 


INTERRUPT 15h - Function DEh, Subfunction 01h 
UPDATE "OPEN WINDOW" MENU 


Purpose: Force DESQview to reread its program list file and rebuild the menu of available programs. 


Available on: All machines. Restrictions: DESQview must be running, 
Registers at call: Return Registers: n/a 
AX = DEOIh 


Details: This function attempts to read DESQVIEW.DVO, and disables the Open Window menu if the file is not in 
the current directory. 
Conflicts: None known. 


INTERRUPT 15h - Function DEh, Subfunction 02h 
SET Unknown FLAG FOR CURRENT WINDOW 


Purpose: unknown. 

Available on: All machines. Restrictions: DESQview version 1.x must be running. 
Registers at call: Return Registers: n/a 

AX = DE02h 





| 
| 
i 
| 
| 
i 
| 
‘ 
| 
{ 
i 
i 


Top View and DESQview/QEMM 15-45 


Details: This call is a NOP in DV 2.x; it may correspond to a TopView function which is no longer necessary. 
Conflicts: None known. 
See Also: Function DEh Subfunction 03h 


INTERRUPT 15h - Function DEh, Subfunction 03h 
GET Unknown Values FOR CURRENT WINDOW 


Purpose: unknown. 


Available on: All machines. Restrictions: DESQview version 1.x must be running. 
Registers at call: Return Registers: 
AX = DEO3h AX = unknown value for current window 


BX = unknown value for current window 
Details: This call is a NOP in DESQview 2.x; it may correspond to a TopView function which is no longer 


necessary. 
Conflicts: None known. 
See Also: Function DEh Subfunction 02h 


INTERRUPT 15h - Function DEh, Subfunction 04h 
GET AVAILABLE COMMON MEMORY 


Purpose: Determine the total and available amounts of memory reserved by DESQview for storing objects, 
messages, and other items. 


Available on: Ali machines. Restrictions: DESQview must be running. 
Registers at call: Return Registers: 
AX = DE04h BX = bytes of common memory available 


CX = largest block available 
DX = total common memory in bytes 


Conflicts: None known. 
See Also: Function DEh Subfunctions 05h and 06h 


INTERRUPT 15h - Function DEh, Subfunction 05h 
GET AVAILABLE CONVENTIONAL MEMORY 


Purpose: Determine the total and available amounts of non-expanded, non-extended memory available for running 


programs. 

Available on: All machines. Restrictions: DESQview must be running. 
Registers at call: Return Registers: 

AX = DE0S5h BX = K of memory available 


CX = largest block available 
DX = total conventional memory in K 


Conflicts: None known. 
See Also: Function DEh Subfunctions 04h and 06h 


INTERRUPT 15h - Function DEh, Subfunction 06h 
GET AVAILABLE EXPANDED MEMORY 


Purpose: Determine the total and available amounts of expanded memory available for allocation or running 


programs. 
Available on: All machines. Restrictions: DESQview must be running. 
Registers at call: Return Registers: 

AX = DEO6h BX = K of expanded memory available 


CX = largest block available 

DX = total expanded memory in K 
Conflicts: None known. 
See Also: Function DEh Subfunctions 04h and 05h 
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INTERRUPT 15h - Function DEh, Subfunction 07h 
"APPNUM” - GET CURRENT PROGRAM'S NUMBER 


Purpose: Determine the caller's position in the "Switch Windows" menu. 


Available on: All machines. Restrictions: DESQview must be running. 
Registers at call: Return Registers: 
AX = DEO7h AX = number of program as it appears on the "Switch 


Windows" menu 
Details: this API call may be made from a hardware interrupt handler 
Conflicts: None known. 
See Also: Function DEh Subfunction 00h 


INTERRUPT 15h - Function DEh, Subfunction 08h 


CHECK Unknown Value 

Purpose: unknown. 

Available on: All machines, Restrictions: DESQview must be running. 

Registers at call: Return Registers: 

AX = DE08h AX = 0000h if unknown value is not set to the current 


task 
0001h if unknown value is set to the current task 
Conflicts: None known. 


INTERRUPT 15h - Function DEh, Subfunction 09h 


UNIMPLEMENTED 

Purpose: This call presumably corresponds to a TopView function which is no longer necessary or meaningful 
under DESQview. 

Available on: All machines, Restrictions: DESQview must be running. 

Registers at call: Return Registers: n/a (NOP in DESQview) 

AX = DEO9h 


Conflicts: None known, 
INTERRUPT 15h - Function DEh, Subfunction 0Ah 
"DBGPOKE" - DISPLAY CHARACTER ON STATUS LINE 


Purpose: The specified character is displayed on the 25th line of the screen; the next call will display in the next 
position (which wraps back to the start of the line if off the right edge of screen). 


Available on: All machines. Restrictions: DESQview version 2.00 or higher must 
be running. 

Registers at call: Return Registers: 

AX = DEQAh Character displayed, next call will display in next 

BL = character position (which wraps back to the start of the line 


if off the right edge of screen) 
Details: Displays character on bottom line of physical screen, regardless of current size of window (even entirely 
hidden). Does not know about graphics display modes, just pokes the characters into display memory. This API cail 
may be made from a hardware interrupt handler. 
Conflicts: None known. 
See Also: TopView Function 10h Subfunction 03h 


INTERRUPT 15h - Function DEh, Subfunction OBh 
"APILEVEL" - DEFINE MINIMUM API LEVEL REQUIRED 


Purpose: Since some calls have slightly different semantics in different versions of DESQview, this call allows an 
older program to use the semantics of the version for which it was written. Conversely, a program can ensure that it 
is not run on older versions of DESQview which may not have all of the API calls the program uses. 


TopView and DESQview/QEMM 15-47 


Available on: All machines. Restrictions: DESQview version 2.00 or higher must 
be running. 

Registers at call: Return Registers: 

AX = DEOBh AX = maximum API level (AL = major, AH = minor) 


BL = API level major version number 


BH = API level minor version number 
Details: If the requested API level is greater than the version of DESQview, a "You need a newer version" error 


window is popped up. The API level defaults to 1.00, and is inherited by child tasks. 
Some early copies of DV 2.00 return AX=0200h instead of 0002h. 
Conflicts: None known. 


INTERRUPT 15h - Function DEh, Subfunction 0Ch 
"GETMEM" - ALLOCATE "SYSTEM" MEMORY 


Purpose: Request a portion of the per-process pool of reserved memory. 


Available on: All machines. Restrictions: DESQview version 2.00 or higher must 
be running. 

Registers at call: Return Registers: 

AX = DEOCh ES:DI -> allocated block or 0000h:0000h (DV 2.26+) 


BX = number of bytes 
Details: Use SETERROR (Function DEh Subfunction 15h) to avoid a user prompt if there is insufficient system 


memory. 
Conflicts: None known. 
See Also: Function DEh Subfunctions 0Dh and 15h, TopView Function 10h Subfunction 01h 


INTERRUPT 15h - Function DEh, Subfunction 0Dh 
"PUTMEM" - DEALLOCATE "SYSTEM" MEMORY 


Purpose: Free a previously allocated block of the per-process pool of reserved memory. 


Available on: All machines. Restrictions; DESQview version 2.00 or higher must 
be running. 

Registers at call: Return Registers: n/a 

AX = DEODh 


ES:DI -> previously allocated block 
Conflicts: None known. 
See Also: Function DEh Subfunction 0Ch, TopView Function 10h Subfunction 02h 


INTERRUPT 15h - Function DEh, Subfunction 0Eh 
"FINDMAIL"- FIND MAILBOX BY NAME 


Purpose: Determine the handle of the mailbox (if any) which has been given the specified string as a name. 


Available on: All machines. Restrictions: DESQview version 2.00 or higher must 
be running. 

Registers at call: Return Registers: 

AX = DEOEh BX = 0000h not found 

ES:DI -> name to find 0001h found 

CX = length of name DS:SI = object handle 


Conflicts: None known. 
See Also: Function 12h Subfunction {1h 


INTERRUPT 15h - Function DEh, Subfunction OFh 

ENABLE DESQview EXTENSIONS 

Purpose: Permit the use of certain extensions to the Top View API provided by DESQview. 

Available on: All machines. Restrictions: DESQview version 2.00 or higher must 
be running. 
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Registers at call: Return Registers: 

AX = DEOFh AX and BX destroyed (seems to be bug, weren't saved 
& restored) 

Details: This function sends a manager stream with opcodes AEh, BDh, and BFh (see Function 12h Subfunction 

OSh) to the task's window. It also enables an additional mouse mode. 

Conflicts: None known, 


INTERRUPT 15h - Function DEh, Subtunction 10h 
"PUSHKEY" - PUT KEY INTO KEYBOARD INPUT STREAM 


Purpose: Store a keystroke such that it will later be read as actual keyboard input by the same process that stored the 
keystroke. 


Available on: All machines, Restrictions: DESQview version 2.00 or higher must 
be running. 

Registers at call: Return Registers: 

AX =DE10h Early copies of DESQview 2.00 destroy 

BH = scan code AX, BX, ES, and DL 


BL = character 

Details: A later read will get the keystroke as if it had been typed by the user. Multiple pushes are read last-in first- 
out. Ifa script exists for the pushed key in the current application, the script will be executed. 

Conflicts: None known. 

See Also: INT 16h Function 05h (chapter 3) 


INTERRUPT 15h - Function DEh, Subfunction 11h 
"JUSTIFY" - ENABLE/DISABLE AUTOMATIC JUSTIFICATION OF WINDOW 


Purpose: Specify whether a window smaller than its virtual screen should automatically shift the origin of its 
viewport whenever the cursor is moved outside the visible area. 


Available on: All machines. Restrictions; DESQview version 2.00 or higher must 
be running. 
Registers at call: Return Registers: n/a 
AX = DE1Ih 
BL=00h viewport will not move 
automatically 
nonzero —_ viewport will move to keep cursor 
visible (default) 


Conflicts: None known, 


INTERRUPT 15h - Function DEh, Subfunction 12h 
"CSTYLE" - SET "C"-COMPATIBLE CONTROL CHAR INTERPRETATION 


Purpose: Specify whether line-ends consist of a carriage return and line feed or a lone linefeed. 


Available on: All machines. Restrictions: DESQview version 2.01 or higher must 
be running. 

Registers at call: Return Registers: n/a 

AX =DE12h 


BX=0000h _ select normal style (linefeed only 
moves down) 
nonzero select C style (linefeed moves to 
start of next line) 
Details: Set on a per-task basis, and inherited from the parent task. 
Conflicts: None known. 


INTERRUPT 15h - Function DEh, Subfunction 13h 
"GETCRIT" - GET CRITICAL NESTING COUNT 


Purpose: Determine how many critical regions are currently in effect. 
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Available on: All machines. Restrictions: DESQview version 2.20 or higher must 
be running. 

Registers at call: Return Registers: 

AX=DE13h BX = number of calls to BEGINC or ENTERC (see 


Function 10h Subfunction 1Bh and Function DEh 

Subfunction 1Ch) without matching ENDC (see 

TopView Function 10h Subfunction 1Ch) 
Details: This API call may be made from within a hardware interrupt handler. 


Conflicts; None known. 
See Also: Function DEh Subfunctions 1Bh and 1Ch, TopView Function 10h Subfunctions 1Bh and 1Ch 


INTERRUPT 15h - Function DEh, Subfunction 14h 


GET OBJECT TYPE 
Purpose: Determine the type of an object given its handle. 
Available on: All machines. Restrictions: DESQview version 2.20 or higher must 
be running. 
Registers at call: Return Registers: 
AX = DEI4h BL = 00h not an object 
ES:D] -> object 08h window or task 
09h mailbox 
OAh keyboard 
OBh timer 
0Ch objectq 
OFh pointer 
10h panel 


Conflicts: None known. 
See Also: TopView Function 10h Subfunction 16h 


INTERRUPT 15h - Function DEh, Subfunction 15h 
"SETERROR" - SET ERROR HANDLING 


Purpose: Specify how DESQview should handle a number of common errors which were always fatal in early 
versions of DESQview. 


Available on: All machines. Restrictions: DESQview version 2.20 or higher must 
be running. 
Registers at call: Return Registers: n/a 
AX = DE15h 
BL=00h post system error on all error 
conditions. 


=O1h return carry flag set on calls to ADDTO, 
SUBFROM, and WRITE messages sent 
to mailboxes which fail due to lack of 
system or common memory. 
=02h (v2.26+) same as Oth, but return null 
pointer for GETMEM calls which fail 
due to lack of system memory. 
Conflicts: None known. 
See Also: Function DEh Subfunction 16h 


INTERRUPT 15h - Function DEh, Subfunction 16h 

"GETERROR" - GET ERROR HANDLING 

Purpose: Determine how DESQview will handle a number of common errors. 

Available on: All machines. Restrictions: DESQview version 2.20 or higher must 
be running. 
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Registers at call: Return Registers: 

AX = DEI6h BL = 00h always post system error 
Olh return carry flag set on failed mailbox writes 
02h return CF set on failed mailbox writes and 
NULL on failed GETMEM calls 

Conflicts: None known. 

See Also; Function DEh Subfunction 15h 


INTERRUPT 15h - Function DEh, Subfunction 17h 


Reserved Function 

Purpose: Not available, perhaps due to an oversight. 

Available on: All machines, Restrictions: DESQview version 2.20 through 2.25 
must be running. 

Registers at call: Return Registers: 

AX = DEI7h pops up "Programming error" window 


Details: AX = 1117h is NOT identical to this call under DESQview 2.20 thru 2.25 
Conflicts: None known. 
See Also: Function 11h Subfunction 17h 


INTERRUPT 15h - Function DEh, Subfunction 17h 
"ASSERTMAP" « GET/SET MAPPING CONTEXT 


Purpose: Force a specified EMS mapping register set into activity, to ensure addressability of a particular program's 
code or data. 


Available on: All machines. Restrictions: DESQview version 2.26 or higher must 
be running. 
Registers at call: Return Registers: 
AX =DEI7h BX = mapping context in effect before call 
BX=0000h get current mapping context without 
setting 


nonzero set new mapping context 
Details: Mapping contexts determine conventional-memory addressability; setting a mapping context ensures that 
the associated program and data areas are in memory for access. Usable by drivers, TSRs and shared programs. 
Caller need not be running under DESQview. This API call may be made from a hardware interrupt handler. 
Conflicts: None known. 
See Also: Function 11h Subfunction 17h, MS Windows INT 2Fh Function 16h Subfunction 85h (chapter 14) 


INTERRUPT 15h - Function DEh, Subfunction 18h 
internal - Unknown Function 


Purpose: unknown. 


Available on: All machines. Restrictions: DESQview version 2.20 or higher must 
be running. 

Registers at call: Return Registers: unknown. 

AX = DE18h 


BP = function number; high byte must be 10h, low 
byte is function: 
00h set unknown value 
BL = unknown (00h-10h, video mode) 
BH = value to store 
03h set unknown value 
BL = unknown (stored in driver) 
OAh get unknown value 
ES:DI -> 18-byte buffer to hold unknown values. 
Details: Calls video driver (NOP for Hercules driver, probably CGA and MCGA also). 
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Conflicts: None known. 


INTERRUPT 15h - Function DEh, Subfunction 19h 
"GETCOMMON" - ALLOCATE "COMMON" MEMORY 


Purpose: Request a portion of the global pool of reserved memory, which is also used by DESQview to store 
objects, messages, and other items. 


Available on: All machines. Restrictions: DESQview version 2.23 or higher must 
be running. 

Registers at call: Return Registers: 

AX = DEI9h AX=0000h — successful 

BX = number of bytes to allocate ES:DI -> allocated block 


nonzero insufficient memory 
Details: This API call may be made from within a hardware interrupt handler. 


Conflicts: None known. 
See Also: Function DEh Subfunctions OCh, 15h, and [Ah 


INTERRUPT 15h - Function DEh, Subfunction 1Ah 
"PUTCOMMON" - DEALLOCATE "COMMON" MEMORY 


Purpose: Free a previously allocated block of the global pool of reserved memory. 


Available on: All machines. Restrictions: DESQview version 2.23 or higher must 
be running. 

Registers at call: Return Registers: n/a 

AX = DEIAh 


DS:SI -> previously allocated block 
Details: This function may be called from within a hardware interrupt handler. 


Conflicts: None known. 
See Also: Function DEh Subfunctions ODh and 19h 


INTERRUPT 15h - Function DEh, Subfunction 1Bh 
internal - DECREMENT CRITICAL NESTING COUNT 


Purpose: Low-level routine to indicate that it is now permissible for DESQview to resume task-switching. 


Available on: All machines. Restrictions: DESQview version 2.23 or higher must 
be running. 

Registers at call: Return Registers: n/a 

AX = DEIBh 


Conflicts: None known. 
See Also: Function DBh Subfunctions 13h and 1Ch, TopView Function 10h Subfunction 1Ch 


INTERRUPT 15h - Function DEh, Subfunction 1Ch 
"ENTERC" - INCREMENT CRITICAL NESTING COUNT 


Purpose: Indicate to DESQview that the calling program is about to enter an uninterruptible section of code, and 
DESQview should temporarily stop task-switching. 


Available on: All machines. Restrictions: DESQview version 2.23 or higher must 
be running. 

Registers at call: Return Registers: n/a 

AX =DEICh 


Details: This call is similar to TopView Function 10h Subfunction 1Bh, but begins the critical region without 
ensuring that DOS is free. The official documentation states that this call should be paired with “ENDC" (Function 
10h Subfunction 1Ch); no mention is made of Function DEh Subfunction 1Bh. This API call may be made from 
within a hardware interrupt handler. 

Conflicts: None known. 

See Also: Function DEh Subfunctions 13h and 1Bh, TopView Function 10h Subfunctions 1Bh and 1Ch 
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INTERRUPT 15h - Function DEh, Subfunction 1Dh 
"PUTKEY" - FAKE USER KEYSTROKES 


Purpose: Control another process by sending it keypresses. 


Available on: All machines. Restrictions: DESQview version 2.23 or higher must 
be running. 
Registers at call: Return Registers: 
AX = DE1Dh AX = 0000h if successful 
DX = segment of handle for task to receive nonzero if receiver's keyboard buffer was full 
keystroke 


BL = character 

BH = scan code 

Details: The key is treated as though the user had pressed it, ignoring any script which may be bound to the key, and 
using the current field table if the keyboard object is in field processing mode. Multiple PUTKEYs are seen in the 
order in which they are executed. 

Conflicts: None known. 

See Also: Function DEh Subfunction 10h 


INTERRUPT 15h - Function DEh, Subfunction 1Eh 
"SCRNINFO" - GET TRUE VIDEO PARAMETERS 


Purpose: Determine the actual video mode and screen size rather than the values presented by the standard BIOS 
functions. 


Available on: All machines. Restrictions: DESQview version 2.23 or higher must 
be running. 

Registers at call: Return Registers: 

AX = DEIEh CL = actual number of rows on screen 


CH = actual number of columns on screen. 
BL = actual video mode (may differ from INT 10h 
Function OFh return) (v2.26+) 
Details: This API call may be made from a hardware interrupt handler. 
Conflicts: None known, 
See Also: INT 10h Function OFh (chapter 5) 


INTERRUPT 15h - Function DEh, Subfunction 1Fh 
"DOSUSER" - GET HANDLE OF TASK CURRENTLY USING DOS 


Purpose: Determine which task, if any, is currently executing a DOS functoin call. 


Available on: All machines. Restrictions: DESQview version 2.23 or higher must 
be running. 
Registers at call: Return Registers: 
AX = DEIFh BX = segment of task handle or 0000h if no tasks are 
using DOS 


Details: This API call may be made from within a hardware interrupt handler, 
Conflicts: None known. 
See Also: Function DEh Subfunction 13h 


INTERRUPT 15h - Function DEh, Subfunction 20h 
"DISPATCHINT" - INTERRUPT ANOTHER TASK 


Purpose: Force a task to execute the specified subroutine, regardless of what it is currently executing. 
Available on: All machines. Restrictions: DESQview version 2.26 or higher must 
be running. 
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Registers at call: Return Registers: n/a 

AX = DE20h 

BX = segment of handle of task to interupt 

DX:CX -> FAR interrupt routine 

Details: Unlike PGMINT (Function 10h Subfunction 21h), DISPATCHINT may be applied to the task making the 
DISPATCHINT call. Multiple DISPATCHINT calls are processed in the order in which they were executed. The 
FAR routine is entered with the current ES, DS, SI, DI, and BP values, using the task's internal stack (see Function 
10h Subfunction 1Ah); only SS:SP needs to be preserved. This API call may be made from within a hardware 
interrupt handler. 

Conflicts: None known. 

See Also: Top View Function 10h Subfunction 21h 


INTERRUPT 15h - Function DEh, Subfunction 21h 
"ASSERTVIR" - CONTROL 386 SCREEN VIRTUALIZATION 


Purpose: Specify whether DESQview-386 should virtualize the display. 


Available on: All machines. Restrictions: DESQview version 2.26 or higher must 
be running. 
Registers at call: Return Registers: 
AX =DE2Ih BX = old state of virtualization 


BX =0000h turn off 
nonzero turn on 
Details: this API call may be made from within a hardware interrupt handler 


Conflicts: None known. 


INTERRUPT 15h - Function DEh, Subfunction 22h 
"PROCESSMEM" - GET TASK MEMORY STATUS 


Purpose: Determine how much memory as task is using, and whether it is currently loaded into memory. 


Available on: All machines, Restrictions: DESQview version 2.26 or higher must 
be running. 
Registers at call: Return Registers: 
AX = DE22h DX = total amount of memory in paragraphs 
DX = segment of task handle BX = amount of system memory in paragraphs 
CX = largest block of system memory available in 
paragraphs 
AX = flags 


bit 0: system memory resides in shared memory 

1; process's memory is swapped out 

2: process's system memory is swapped out 
Details: If the task handle is a child task, the returned values will be for the process containing the task, rather than 
the task itself, If the process's system memory is swapped out, BX,CX,DX remain unchanged, because the memory 
usage cannot be determined. 
Conflicts: None known. 
See Also: Function DEh Subfunctions 04h, 05h, and 06h 


INTERRUPT 15h - Function DEh, Subfunction 23h 


Unknown Function 

Purpose: unknown. 

Available on: All machines. Restrictions: DESQview version 2.31 or higher must 
be running. 

Registers at call: Return Registers: unknown. 

AX = DE23h 


BX = unknown. 
CX = unknown. 
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Conflicts: None known. 


INTERRUPT 2th - Function 2Bh 


INSTALLATION CHECK 
Purpose: Determine whether DESQview is installed. 
Available on: All machines, Restrictions: none. 
Registers at call: Return Registers: 
AH = 2Bh AL = FFh if DESQview not installed 
AL = subfunction (DV v2.00+): 
Olh get version BX = version 
BH = major, BL = minor 
Note: early copies of v2.00 return 0002h 
02h get shadow buffer info, and start BH = rows in shadow buffer 
shadowing BL = columns in shadow buffer 
DX = segment of shadow buffer 
04h get shadow buffer info BH = rows in shadow buffer 
BL = columns in shadow buffer 
DX = segment of shadow buffer 
O5h stop shadowing 


CX = 4445h (‘DE’) 

DX = 5351h (‘SQ’) 
Details: In DESQview v1.x, there were no subfunctions; this call only identified whether or not DESQview was 
loaded. 
Conflicts: DOS Set System Date (chapter 8), PC Tools v5.1 PC-CACHE (chapter 6), peANY WHERE IV (chapter 
28), ELRES v1.1 (chapter 36), TAME (chapter 36). 
See Also; INT 10h Functions FEh and FFh 


DESQview 2.26 External Device Interface 

The functions in this section are called by DESQview itself, and should not be called by applications (except 
subfunctions 00h and 01h). The XDI permits programs (usually TSRs loaded before DESQview) to keep track of the 
state of the system under DESQview. 


INTERRUPT 2Fh - Function DEh, Subfunction 00h 


INSTALLATION CHECK 

Purpose: Determine whether any External Device Interface drivers are installed. 

Available on: All machines, Restrictions: none. 

Registers at call: Return Registers: 

AX =DE00h AL = FFh if installed (even if other registers do not 
BX = 4445h ("DE") match) 

CX = 5844h ("XD") if BX,CX, and DX were as specified on entry, 

DX = 4931h ("11") BX = 4845h ("HE") 


CX = 5245h ("RE") 

DX = 4456h ("DV") 
Details: AH=DEh is the default XDI multiplex number, but may range from COh-FFh. Programs should check for 
XDI starting at DEh to FFh, then COh to DDh. The XDI handler should not issue any DOS or BIOS calls, nor should 
it issue DESQview API calls other than those allowed from hardware interrupts. 


INTERRUPT 2Fh - Function DEh, Subfunction 01h 


DRIVER CUSTOM SUBFUNCTION 


Purpose: Allow communication with resident XDI drivers. 
Available on: All machines. Restrictions: XDI driver must be installed. 
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Registers at call: Return Registers: varies with driver and inputs 
AX = DEOIh 
BX = driver ID (5242h "RB" will be used by future 
programs by Ralf Brown) 
other registers as needed by driver 
Details: XDI drivers should pass this call through to the previous handler if the ID does not match. DESQview never 
calls this function. 
Conflicts: None known. 


INTERRUPT 2Fh - Function DEh, Subfunction 01h 


DVTXDI.COM API 
Purpose: Allow communication between DVTree or DVTMAN and the resident DVTXDI driver. 
Available on: All machines. Restrictions: DVTXDI must be resident. 
Registers at call: Return Registers: 
AX =DEOih BX = 4F4Bh ("OK") 
BX = 7474h DL = DL destroyed 
CL = funetion 
00h installation check AL = FFh 
Olh get process handle AX = process handle or 0000h if not running 


DX = keys on Open Window menu 
(DL = first, DH = second) 
02h (v1.3+) set TMAN handle 
DX = TMAN process handle 
03h (v1.3+) set set open keys to ignore on 
next subfunc O1h call 
DX = keys on Open Window menu 


Details: DVTXDI is distributed as part of the shareware products DVTree (DOS shell/DESQview process manager) 
and DVTMAN by Mike Weaver. 
Conflicts: None known. 


INTERRUPT 2Fh - Function DEh, Subfunction 01h 
DESQview 2.26 XMS XDI driver - Possible INSTALLATION CHECK 


Purpose: Determine whether the DVXMS.DVR driver is loaded. 


Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AX = DEOIh AL = FFh 

BX = FFFEh DX = 584Dh ("XM") 
CX =4D47h 

DX = 0052h 


Conflicts: None known. 


INTERRUPT 2Fh - Function DEh, Subfunction 02h 
DESQview INITIALIZATION COMPLETE 


Purpose: Called by DESQview to indicate to any interested programs that it is now executing, allowing those 
programs to make any necessary preparations for operation with DESQview. 


Available on: All machines. Restrictions: DESQview version 2.26 or higher must 
be running. 

Registers at call: Return Registers: n/a 

AX = DEO2h 


BX = mapping context of DESQview 
DX = handle of DESQview system task 
Details: The driver should pass this call to the previous handler after doing its work. 
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Conflicts: None known, 
See Also: Function DEh Subfunction 03h 


INTERRUPT 2Fh - Function DEh, Subfunction 03h 
DESQview TERMINATION 


Purpose: Called by DESQview to indicate that it is exiting, allowing any interested programs to perform whatever 
cleanup is necessary to resume normal DOS operation. 


Available on: All machines. Restrictions: DESQview version 2.26 or higher must 
be running. 

Registers at call: Return Registers: n/a 

AX = DE03h 


BX = mapping context of DESQview 

DX = handle of DESQview system task 

Details: The driver should pass this call to the previous handler before doing its work, DESQview makes this call 
when it is exiting, but before unhooking any interrupt vectors. 

Conflicts: None known. 

See Also: Function DEh Subfunction 02h 


INTERRUPT 2Fh - Function DEh, Subfunction 04h 


ADD PROCESS 

Purpose: Called by DESQview to indicate to any interested programs that it is creating a new process. 

Available on: All machines, Restrictions: DESQview 2.26 or higher must be 
running. 

Registers at call: Return Registers: n/a 

AX = DE04h 


BX = mapping context of new process 

DX = handle of process 

Details: The XMS XDI handler (installed by default) allocates a 22-byte record (see below) from “common” 
memory to control access to XMS memory. All DOS, BIOS, and DV API calls are valid in handler. The driver 
should pass this call to the previous handler after processing it. 

Conflicts: None known. 

See Also: Function DEh Subfunction 05h 


Table 15-8. Format of XMS XDI structure: 


Offset Size Description 

00h DWORD pointer to /0-byte record 

04h DWORD pointer to next XMS XDI structure 

O8h WORD mapping context 

OAh BYTE unknown. 

OBh SBYTEs XMS entry point to return for INT 2Fh Function 43h Subfunction 10h (chapter 10) 
(FAR jump to next field) 

10h 6BYTEs FAR handler for XMS driver entry point (consists of a FAR CALL followed by RETF) 

INTERRUPT 2Fh - Function DEh, Subfunction 05h 

REMOVE PROCESS 

Purpose: Called by DESQview to indicate to any interested programs that it is terminating a process. 

Available on: All machines. Restrictions: DESQview 2.26 or higher must be 

running. 
Registers at call: Return Registers: n/a 
AX = DE05h 


BX = mapping context of process 
DX = handle of last task in process 
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Details: XMS XDI handler releases the structure allocated by Function DEh Subfunction 04h. The driver should 
pass this call to the previous handler before processing it. All DOS, BIOS, and DV API calls except those generating 
a task switch are valid in handler. 

Conflicts: None known. 

See Also: Function DEh Subfunction 04h 


INTERRUPT 2Fh - Function DEh, Subfunction 06h 
CREATE TASK 


Purpose: Called by DESQview to indicate to any interested programs that it is creating a new thread of execution 
within a process. 


Available on: All machines. Restrictions: DESQview 2.26 or higher must be 
running. 
Registers at call: Return Registers: n/a 
AX = DE06h 
BX = mapping context of the process containing 
task 


DX = handle of new task 
Details: The driver should pass this call to the previous handler after processing it. AI! DOS, BIOS, and DV API 


calls are valid in handler. 
Conflicts: None known, 


INTERRUPT 2Fh - Function DEh, Subfunction 07h 


TERMINATE TASK 

Purpose: Called by DESQview to indicate to any interested programs that it is terminating a thread of execution. 

Available on: All machines, Restrictions: DESQview 2.26 or higher must be 
running. 

Registers at call: Return Registers: n/a 

AX = DEO7h 

BX = mapping context of the process containing 

task 


DX = handle of task 

Details: The driver should pass this call to the previous handler before processing it. All DOS, BIOS, and DV API 
calls except those generating a task switch are valid in handler. 

Conflicts: None known. 


INTERRUPT 2Fh - Function DEh, Subfunction 08h 
SAVE STATE 


Purpose: Called by DESQview to permit interested programs to save their current state in preparation for a context 
switch. 


Available on: All machines. Restrictions: DESQview 2.26 or higher must be 
Tunning, 

Registers at call: Return Registers: n/a 

AX = DE08h 


BX = mapping context of task being switched from 

DX = handle of task being switched from 

Details: Invoked prior to task swap, interrupts, etc. The driver should pass this call to the previous handler after 
processing it. 

Conflicts: None known. 


INTERRUPT 2Fh - Function DEh, Subfunction 09h 
RESTORE STATE 


Purpose: Called by DESQview to permit interested programs to restore a previously saved state after a context 
switch. 


| 
i 
| 
1 
i 
} 
\ 
1 
| 
} 





15-58 TopView and DESQview/QEMM 


Available on: All machines. Restrictions: DESQview 2.26 or higher must be 
running. 

Registers at call: Return Registers: n/a 

AX = DE09h 


BX = mapping context of task being switched to 

DX = handle of task being switched to 

Details: State is restored except for interrupts. The driver should pass this call to the previous handler before 
processing it. 

Conflicts: None known. 


INTERRUPT 2Fh - Function DEh, Subfunction 0Ah 
CHANGE KEYBOARD FOCUS 


Purpose: Called by DESQview to indicate to interested programs that the user has made a different window the 
foreground window. 


Available on: All machines. Restrictions: DESQview 2.26 or higher must be 
running, 

Registers at call: Return Registers: n/a 

AX = DEOAh 


BX = mapping context of task receiving focus 

DX = handle of running task 

Details: The driver should pass this call to the previous handler before processing it. This call often occurs inside a 
keyboard interrupt, 

Conflicts: None known. 


INTERRUPT 2Fh - Function DEh, Subfunction OBh 
DVP PROCESSING COMPLETE 


Purpose: Called by DESQview to permit indicated programs to examine or modify the program information file for 
a program which is being started up. 


Available on: All machines. Restrictions: DESQview 2.26 or higher must be 
Tunning. 

Registers at call: Return Registers: 

AX = DEOBh CX incremented as needed 


BX = mapping context of DESQview system task 
CX = number of system memory paragraphs 
required for the use of all XDI drivers (DV will 
add this-to system memory in DVP buffer) 
DX = handle of DESQview system task 
SI = mapping context of new process if it starts 
ES:DI -> DVP buffer 
Details: Once DV invokes this function, the DVP buffer contents may be changed. The driver should pass this call to 
the previous handler before processing it. 
Conflicts: None known. 


INTERRUPT 2Fh - Function DEh, Subfunction 0Ch 


SWAP OUT PROCESS 

Purpose: Called by DESQview to indicate to interested programs that a process is about to be written to disk and 

suspended. 

Available on: All machines. Restrictions: DESQview 2.26 or higher must be 
running. 

Registers at call: Return Registers: n/a 


AX = DEOCh 
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BX = mapping context of task being swapped out 

DX = handle of DESQview system task 

Details: The driver should pass this call to the previous handler after processing it. 
Conflicts: None known. 


INTERRUPT 2Fh - Function DEh, Subfunction ODh 
SWAP IN PROCESS 


Purpose: Called by DESQview to indicate to interested programs that a process is being placed back in memory 
from disk. 


Available on: All machines. Restrictions: DESQview 2.26 or higher must be 
running. 

Registers at call: Return Registers: n/a 

AX = DEODh 


BX = mapping context of process just swapped in 

DX = handle of DESQview system task 

Details: The driver should pass this call to the previous handler before processing it. 
Conflicts: None known. 


INTERRUPT 2Fh - Function DEh, Subfunction OEh 
DVP START FAILED 


Purpose: Called by DESQview to indicated to interested programs that the attempted startup of a program was 
unsuccessful. 


Available on: All machines. Restrictions; DESQview 2.26 or higher must be 
running, 

Registers at call: Return Registers: n/a 

AX = DEOEh 


BX = mapping context of DESQview system task 
DX = handle of DESQview system task 
SI = mapping context of failed process (same as for 
call to Function DEh Subfunction OBh) 
Details: The driver should pass this call to the previous handler after processing it. 
Conflicts: None known. 


Quarterdeck Programs 

In addition to DESQview, Quarterdeck Office Systems produces a number of other programs, some of which are 
either resident or optionally resident. Among those, QEMM-386, QRAM (pronounced "cram"), MANIFEST, and 
VIDRAM provide function calls on the Multiplex interrupt. There is one general installation check to determine 
whether any of the above are installed, permitting all of the programs to share a single multiplex number, and 
specific installation checks for each of the programs. 


INTERRUPT 2Fh - Function D2h, Subfunction 00h 


INSTALLATION CHECK 

Purpose: Determine whether any Quarterdeck programs are loaded. 

Available on: All machines. Restrictions: none. 

Registers at call: Return Registers: 

AX = D200h AL = FFh if any Quarterdeck resident programs 
BX = 5144h ("QD") installed 

CX = 4D45h ("ME") if BX,CX,DX were specified on entry: 

DX = 4D30h ("MO") BX = 4D45h ("ME") 


CX = 4D44h ("MD") 

DX = 5652h ("VR") 
Details: QEMM/QRAM/VIDRAM/MANIFEST will search for a free AH value from D2h through FFh, then COh 
through DIh. Once one of the programs has been installed, all others will use the same multiplex number. 
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Conflicts: None known. 
See Also: MANIFEST Function D2h, QEMM/QRAM Function D2h, VIDRAM Function D2h 


Quarterdeck MANIFEST 
INTERRUPT 2Fh - Function D2h, Subfunction 01h 


INSTALLATION CHECK 

Purpose: Determine whether MANIFEST has been loaded as a TSR. 

Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AX = D20ih BX = 5354h ("ST") 


BX = 4D41h ("MA") 

CX = 4E49h ("NI") 

DX = 4645h ("FE") 

Details: QEMM/QRAM/VIDRAM/MANIFEST will search for a free AH value from D2h through FFh, then COh 
through Dlh. 

MANIFEST chains to the previous INT 2Fh handler if BX/CX/DX are not as specified. 

Conflicts: None known. 

See Also: QEMM/QRAM Function D2h Subfunction 01h, VIDRAM Function D2h Subfunction 01h 


Quarterdeck QEMM/QRAM 5.0 
INTERRUPT 2Fh - Function D2h, Subfunction 01h 


GET HIRAM MEMORY CHAIN 

Purpose: Determine the address of the first block of high memory. 

Available on: All machines. Restrictions: QEMM version 5.0 or higher, or QRAM, 
must be running. 

Registers at call: Return Registers: 

AX =D201h BX = 4F4Bh ("OK") 

BX = 4849h ("HI") CX = segment of start of HIRAM chain 

CX = 5241h ("RA") DX = QEMM/QRAM cade segment 


DX = 4D30h ("MO") 

Details: QEMM, QRAM, VIDRAM, and MANIFEST will search for a free AH value from D2h through FFh, then 
COh through Dih. QEMM and QRAM both responded the same. The HIRAM memory chain has the same format as 
the regular DOS 4.0 memory chain (see INT 21h Function 52h in chapter 8), except that XMS Upper Memory 
Blocks have the block header program name field set to "UMB". 

QEMM and QRAM chain to the previous INT 2Fh handler if BX/CX/DX are not as specified. 

Conflicts; None known. 

See Also: MANIFEST Function D2h Subfunction 01h, VIDRAM Function D2h Subfunction 01h 


INTERRUPT 2Fh - Function D2h, Subfunction 01h 


INSTALLATION CHECK 

Purpose: Determine whether QEMM-386 version 5.0 or higher, is installed. 

Available on: All machines. Restrictions: none. 

Registers at call: Return Registers: 

AX = D201h BX = 4F4Bh ("OK") 

BX = 5145h ("QE") ES:DI -> QEMM/QRAM entry point 


CX = 4D4Dh ("MM") 
DX = 3432h ("42") 
Details: QEMM/QRAM/VIDRAM/MANIFEST will search for a free AH value from D2h through FFh, then COh 
through Dih. QEMM and QRAM both respond the same. 
QEMM and QRAM chain to the previous INT 2Fh handler if BX/CX/DX are not as specified. 
Conflicts: None known. 
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See Also: VIDRAM Function D2h Subfunction 01h, MANIFEST Function D2h Subfunction 01h 
Quarterdeck VIDRAM 5.0 


INTERRUPT 2Fh - Function D2h, Subfunction 01h 
Quarterdeck VIDRAM 5.0 » INSTALLATION CHECK 


Purpose: Determine whether VIDRAM is installed, and if so, the address to call to make requests of VIDRAM. 


Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AX =D20th BX = 4F4Bh ("OK") if installed 
BX = 5649h ("VI") ES:DI -> VIDRAM entry point 


CX = 4452h ("DR") 

DX = 414dh ("AM") 

Details: QEMM/QRAM/VIDRAM/MANIFEST will search for a free AH value from D2h through FFh, then COh 
through Dth, 

VIDRAM chains to the previous INT 2Fh handler if BX/CX/DX are not as specified. 

Conflicts: None known. 

See Also: QEMM/QRAM Function D2h Subfunction 01h, MANIFEST Function D2h Subfunction 01h 


Call VIDRAM entry point with: 
AH = 00h get status 


VIDRAM returns: 
AL = VIDRAM state (00h off, 01h no EGA graphics, 02h no graphics) 
BL = flags 
bit 0: unknown. 
bits 1-7 not used 
BH = unknown, 
CL = current monitor (01h = mono, 80h = color) 
SI = current top of memory (paragraph) 
DI = segment of unknown. 


Call VIDRAM entry point with: 
AH = 01h setup 
AL = VIDRAM state (as returned by function 00h) 
BL = flags (as returned by function 00h) 
BH = unknown. 
CL = monitor (as returned by function 00h) 
SI = new top of memory (paragraph) 


VIDRAM returns: 
unknown 


Call VIDRAM entry point with: 
AH = 02h get unknown pointer. 
ES:DI -> unknown data 


VIDRAM returns: 
CF set on error 
CF clear if successful 
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MultiDOS Plus 


MultiDOS Plus is a multitasker by Nanosoft, Inc. The description of the API and a full-featured, but time-limited, 
demonstration version of MultiDOS are available for free on the Nanosoft BBS. 


INTERRUPT 14h - Function 04h 


INITIALIZE PORT 

Purpose: Establish operating conditions for the specified serial port. 

Available on: All machines. Restrictions: MultiDOS Plus IODRV software must 
be installed. 

Registers at call: Return Registers: n/a 

AH = 04h 


Details: The desired serial port is initialized; if a Hayes-compatible modem is attached, a connection has been estab- 
lished on return. The port number is stored at offset BEh in the Task Control Block (see INT 15h Function 13h). 
Conflicts: SERIAL 1/O (chapter 7), FOSSIL (chapter 7). 

See Also: Functions 05h and 20h, INT 15h Function 13h, Serial I/O Function 00h (chapter 7) 


INTERRUPT 14h - Function 05h 
READ CHARACTER FROM PORT 
Purpose: Read one character from the specified port, waiting if necessary. 


Available on: All machines. Restrictions: MultiDOS Plus IODRV software must 
be installed, 
Registers at call: Return Registers: 
AH = 05h AL = status: 
AL = timeout in seconds (00h = never) 00h successful 
AH = character read 
Oth read error 


02h timed out 
other modem status (CTS, DSR) changed 
Details: The port number is stored at offset BEh in the Task Control Block (see INT 15h Function 13h). 
Conflicts: SERIAL J/O (chapter 7), FOSSIL (chapter 7). 
See Also: Functions 04h, 06h, and 22h, Serial I/O Function 02h (chapter 7) 


INTERRUPT 14h - Function 06h 


WRITE CHARACTER TO PORT 

Purpose: Output one character to the specified serial port. 

Available on: All machines, Restrictions: MultiDOS Plus IODRV software must 
be installed. 

Registers at call: Return Registers: 

AH = 06h AL = status 

AL = character 00h successful 


Details: The port number is stored at offset BEh in the Task Control Block (See INT 15h Function 13h). If output 
queue is full, the calling task is blocked until the character can be stored. 
Conflicts: FOSSIL (chapter 7). 
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See Also: Functions 04h, 05h, and 21h, Serial I/O Function 01h (chapter 7) 
INTERRUPT 14h - Function 07h 


GET PORT STATUS 

Purpose: Determine conditions at the specified serial port. 

Available on: Ali machines, Restrictions: MultiDOS Plus IODRV software must 
be installed. 

Registers at call: Return Registers: 

AH=07h CL = modem status (see Function 23h) 


CH = character at head of input queue (if any) 

DX = number of characters in input queue 
Details: The port number is stored at offset BEh in the Task Control Block (See INT 15h Function 13h). 
Conflicts: FOSSIL (chapter 7). 


INTERRUPT 14h - Function 08h 
GET AND RESET PORT LINE STATUS 


Purpose: Determine line status for the specified port. 


Available on: All machines, Restrictions: MultiDOS Plus 4.0 or higher IODRV 
software must be installed. 
Registers at call: Return Registers: 
AH = 08h AL = line status (see Function 23h) 
AH destroyed 


Details: The port number is stored at offset BEh in the Task Control Block (See INT 15h Function 13h). On every 
line status change, the line status is ORed with the line status accumulator; this function returns the accumulator and 
clears it. 

Conflicts: FOSSIL (chapter 7). 

See Also: Functions 04h and 07h, Serial I/O Function 03h (chapter 7) 


INTERRUPT 14h - Function 09h 


RESET PORT STATUS 

Purpose: Resets the status byte of the specified port. 

Available on: All machines. Restrictions: MultiDOS Plus JODRV software must 
be installed. 

Registers at call: Return Registers: 

AH = 09h Modem status byte cleared. 


Details: The port number is stored at offset BEh in the Task Control Block (see INT 15h Function 13h), 
Conflicts: FOSSIL (chapter 7), 
See Also: Functions 04h and 07h. 


INTERRUPT 14h - Function 20h 


INITIALIZE PORT 
Purpose: Establish operating conditions for the specified serial port. 
Available on: All machines. Restrictions: MultiDOS Plus must be installed. 
Registers at call: Return Registers: 
AH = 20h AH = status: 
AL = port parameters (see Serial I/O Function 00h 00h successful 
in chapter 7) 41h no such port 
DX = port number (0-3) 64h monitor mode already active 


Conflicts: XOO FOSSIL (chapter 7), Alloy MW386 (chapter 18). 
See Also: Functions 04h, 21h, and 23h, Serial I/O Function 00h (chapter 7) 
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INTERRUPT 14h - Function 21h 

TRANSMIT CHARACTER 

Purpose: Transmit one character out the specified port. 
Available on: All machines. 

Registers at call: 

AH =21h 

AL = character to send 

DX = port number 


MultiDOS Plus 


Restrictions: MultiDOS Plus must be installed. 
Return Registers: 
AH = status: 


00h successful 

39h no DSR or CTS 

3Ch no DSR 

3Bh no CTS 

41h no such port 

42h monitor mode not active 
97h timed out 


Details: Monitor mode must have been turned on with Function 24h before calling. 
Conflicts: XOO FOSSIL (chapter 7), Alloy MW386 (chapter 18). 


See Also: Functions 20h, 22h and 24h 


INTERRUPT 14h - Function 22h 
RECEIVE CHARACTER 


Purpose: Receive one character from the specified port. If no character is available, this function waits until a 


character arrives or an implementation-dependent timeout elapses. 


Available on: All machines. 
Registers at call: 

AH = 22h 

DX = port number 


Conflicts: None known. 
See Also: Functions 20h, 21h, and 27h 


INTERRUPT 14h - Function 23h 
GET PORT STATUS 


Purpose: Determine the status of the specified serial port. 


Available on: Ali machines. 
Registers at call: 

AH = 23h 

DX = port number 


Restrictions: MultiDOS Plus must be installed. 
Return Registers: 
AH = status (see also Function 21h): 

00h successful 

AL = character 

3Dh framing and parity error 

3Eh overrun error 

3Fh framing error 

40h parity error 

96h ring buffer overflow 


Restrictions: MultiDOS Plus must be installed. 
Return Registers: 
AH = line status: 
bit 7: timeout 
6; transmit shift register empty 
5: transmit holding register empty 
4: break detected 
3: framing error 
2: parity error 
f: overrun error 
0: receive data ready 
AL = modem status: 
bit 7: carrier detect 
6: ring indicator 
5: data set ready 
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4: clear to send 

3: delta carrier detect 

2: trailing edge of ring indicator 

1: delta data set ready 

0: delta clear to send 
Details: The returned status flags are identical to those returned by Serial I/O Function 03h (chapter 7). 
Conflicts: Alloy MW386 (chapter 18). 
See Also: Functions 07h and 20h, Serial I/O Function 03h (chapter 7) 


INTERRUPT 14h - Function 24h 


SET MONITOR MODE 
Purpose: Control status reporting for the specified port. 
Available on: Ali machines, Restrictions: MultiDOS Plus must be installed. 
Registers at call: Return Registers: 
AH = 24h AH = status: 
AL = port status storage: 00h successful 

OOh single status for entire receive buffer 3Ah invalid status storage specified 

Oth separate status kept for each byte in receive 41h no such port 

buffer 64h monitor mode already active 


DX = port number 

Details: In monitor mode, MultiDOS redirects all BIOS video output to a serial port. 
Conflicts: Alloy MW386 (chapter 18). 

See Also: Functions 20h and 25h 


INTERRUPT 14h - Function 25h 


CLEAR BUFFERS 
Purpose: Flush the buffers for the specified port and optionally deactivate the port. 
Available on: All machines. Restrictions; MultiDOS Plus must be installed. 
Registers at call: Return Registers: 
AH = 25h AH = status: 
AL = function: 00h successful 
00h only clear buffers 3Ah invalid function 
Oih clear buffers and deactivate 41h no such port 
DX = port number 42h monitor mode not active 


Conflicts: None known. 
See Also: Functions 20h and 24h 


INTERRUPT 14h - Function 27h 
GET BUFFER CHARACTER COUNT 


Purpose: Determine how many characters are available for reading from the serial port. 


Available on: All machines. Restrictions: MultiDOS Plus must be installed. 
Registers at call: Return Registers: 

AH = 27h AH & status 

DX = port number 00h successful 


41h no such port 
42h monitor mode not active 
AL = number of characters in receive buffer 
Conflicts: None known. 


INTERRUPT 15h - Function 00h 
GIVE UP TIME SLICE 


Purpose: Indicate that the caller is idle and that MultiDOS may give the rest of its time slice to other programs. 
Available on: All machines. Restrictions: MultiDOS Plus must be running. 
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Registers at call: Return Registers: n/a 

AH = 00h 

Details: If this call is issued by the highest-priority task while MultiDOS is using priority-based rather than round- 
robin scheduling, control will be returned to the caller immediately. 

Conflicts: Cassette (chapter 3), Amstrad PC1512 (chapter 4), VMiX (chapter 17). 

See Also: Function 03h, TopView Function 10h Subfunction 00h (chapter 15) 


INTERRUPT 15h - Function 01h 
REQUEST RESOURCE SEMAPHORE 


Purpose: Gain exclusive access to a resource, suspending the caller if necessary. 


Available on: Ali machines. Restrictions: MultiDOS Plus must be running. 
Registers at call: Return Registers: 

AH=0lh AH = status 

AL = semaphore number (00h-3Fh) 00h successful 


02h invalid semaphore number 
Details: If the semaphore is not owned, ownership is assigned to the calling task and the call returns immediately, If 
the semaphore is already owned by another task, the calling task is placed on a queue for the semaphore and 
suspended until it can become owner of the semaphore. Semaphore 0 is used internally by MultiDOS to synchronize 
DOS access, 
Conflicts: Cassette (chapter 3), Amstrad PC1512 (chapter 4), VMiX (chapter 17). 
See Also: Functions 02h, 10h, and 1Bh 


INTERRUPT 15h - Function 02h 
RELEASE RESOURCE SEMAPHORE 


Purpose: Indicate that other tasks may now access the resource controlled by the specified semaphore. 


Available on: All machines. Restrictions: MultiDOS Plus must be running, 
Registers at call: Return Registers: 
AH = 02h AH = status 
AL = semaphore number (O0h-3Fh) 00h successful 
Olh not semaphore owner 


02h invalid semaphore number 
Details: If any tasks are waiting for the semaphore, the first task on the wait queue will become the new owner and 
be reawakened. Do not use within an interrupt handler, 
Conflicts: Cassette (chapter 3), Arnstrad PC1512 (chapter 4), VMixX (chapter 17). 
See Also: Functions 01h, 10h, and 1Ch 


INTERRUPT 15h - Function 03h 
SUSPEND TASK FOR INTERVAL 


Purpose: Request that the caller not receive control of the CPU for the indicated period. 


Available on: All machines. Restrictions: MultiDOS Plus must be running, 
Registers at call: Return Registers: 
AH = 03h after specified interval has elapsed 


DX = number of time slices to remain suspended 

Details: When priority-based scheduling is in use, high-priority tasks should use this function to yield the processor. 
Conflicts: Cassette (chapter 3), Amstrad PC1512 (chapter 4), VMixX (chapter 17). 

See Also: Functions 00h and 0Ah 


INTERRUPT 15h « Function 04h 
SEND MESSAGE TO ANOTHER TASK 


Purpose: Append data to the specified mailbox. 
Available on: All machines. Restrictions: MultiDOS Plus must be running. 
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Registers at call: Return Registers: 

AH = 04h AH = status 

AL = mailbox number (00h-3Fh) 00h successful 

CX = message length in bytes O1h out of message memory 
DS:SI -> message 02h invalid mailbox number 


Details: The message is copied into a system buffer; the caller may immediately reuse its buffer. 
See Also: Function 05h 


INTERRUPT 15h - Function 05h 


CHECK MAILBOX 
Purpose: Determine whether any messages have been received. 
Available on: All machines. Restrictions: MultiDOS Plus must be running. 
Registers at call: Return Registers: 
AH = 05h AH = status 
AL = mailbox number (00h-3Fh) 00h successful 
DX = length of first message in queue, 
0000h if no message 


02h invalid mailbox number 
Conflicts: System - Build ABIOS Initialisation Table (chapter 3), Amstrad PC1512 (chapter 4), VMiX (chapter 17). 
See Also: Functions 04h and 06h 


INTERRUPT 15h - Function 06h 


READ MAILBOX 

Purpose: Retrieve the next message in the indicated mailbox. 

Available on: All machines. Restrictions: MultiDOS Plus must be running. 
Registers at call: Return Registers: 

AH = 06h ’ AH = status 

AL = mailbox number (O0h-3Fh) 00h successful 

CX = size of buffer in bytes CX = number of bytes copied 

ES:DI -> buffer for message DX = actual length of message 


02h invalid mailbox number 
Details: If the caller's buffer is not large enough, the message is truncated and the remainder is lost. 
Conflicts: Amstrad PC1512 (chapter 4), VMiX (chapter 17). 
See Also: Functions 04h and 05h 


INTERRUPT 15h - Function 07h 
SPAWN INTERNAL TASK (CREATE NEW THREAD) 


Purpose: Start a new thread of execution which will perform subroutines independent of the existing thread of 
execution, 


Available on: All machines. Restrictions: MultiDOS Plus must be running. 
Registers at call: Return Registers: 

AH = 07h AH = status 

BX:CX = entry point of new task 00h successful 

DX = stack size in paragraphs O1h no free task control blocks 


02h no free memory for task's stack 
Details: Execution returns immediately to calling task. 
Conflicts: VMiX (chapter 17). 
See Also: Functions 08h, 09h, and 13h 


INTERRUPT 15h - Function 08h 
TERMINATE INTERNAL TASK (KILL THREAD) 


Purpose: Stop an independent thread of execution. 
Available on: All machines. Restrictions: MultiDOS Plus must be running. 
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Registers at call: Return Registers: 
AH=08h calling task terminated, so execution never returns to 
caller 


Details: An internal task must be terminated with this function rather than a DOS termination function. Task's stack 
space is returned to parent task's memory pool. 

Conflicts: VMiX (chapter 17). 

See Also: Function 07h 


INTERRUPT 15h - Function 09h 


CHANGE TASK’S PRIORITY 

Purpose: Specify the relative importance of the calling task. 

Available on: All machines. Restrictions: MultiDOS Plus must be running. 
Registers at call: Return Registers: n/a 

AH = 09h 


AL = new priority 

Details: The priority has different meanings depending on whether priority-based or round-robin scheduling is used, 
Conflicts: VMixX (chapter 17). 

See Also: Function 07h 


INTERRUPT 15h - Function 0Ah 
CHANGE TIME SLICE INTERVAL 


Purpose: Specify the desired granularity of time slices. 


Available on: All machines. Restrictions: MultiDOS Plus must be running. 
Registers at call: Return Registers: n/a 
AH =0Ah 


AL = new interval 
00h = 55,0 ms (default) 


80h = 27.5 ms 

40h = 13.75 ms 

20h = 6,88 ms 

10h = 3.44 ms 

08h = 1.72 ms 
Conflicts: VMiX (chapter 17). 
See Also: Function 03h 


INTERRUPT 15h - Function OBh 
FORCE DISPLAY OUTPUT TO PHYSICAL SCREEN MEMORY 


Purpose: Request that video output be sent directly to the display rather than to a virtual screen, 


Available on: All machines. Restrictions: MultiDOS Plus must be running. 
Registers at call: Return Registers: n/a 
AH =OBh 


Details: Sets calling task's screen pointer to actual screen memory; the pointer may be restored with Function 0Ch. 
Caller’s video mode must be same as foreground task’s video mode. Any text written while in the background will be 
saved to the foreground task's virtual screen when it switches to the background. Useful if a background task wants 
to display a message on the foreground screen. 

Conflicts: VMixX (chapter 17). 

See Also: Function 0Ch 


INTERRUPT 15h - Function 0Ch 
RESTORE OLD VIDEO DISPLAY MEMORY 


Purpose: Request that video output be sent to a virtual screen rather than the actual display. 
Available on: All machines. Restrictions: MultiDOS Plus must be running. 
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Registers at call: Return Registers: n/a 

AH = 0Ch 

Details: Restores task's screen pointer saved by Function OBh; must not be called unless Function OBh has been 
called first, 

Conflicts: VMix (chapter 17). 

See Also: Function OBh 


INTERRUPT 15h - Function 0Dh 
DISABLE MULTITASKING 


Purpose: Temporarily suspend time-slicing to allow the caller to process time-ciritcal events or nonreentrant code. 
Available on: All machines. Restrictions: MultiDOS Plus must be running, 
Registers at call: Return Registers; n/a 

AH = 0Dh 

Details: Calling task receives all time slices until Function OEh is called. 

Conflicts: VMiX (chapter 17). 

See Also: Functions 0Eh, 10h, and 20h, TopView Function 10h Subfunction 1Bh (chapter 15) 


INTERRUPT 15h - Function 0Eh 


ENABLE MULTITASKING 

Purpose: Restart time-slicing after the caller has processed a time-critical event or nonreentrant code, 
Available on: All machines. Restrictions: MultiDOS Plus must be running. 
Registers at call: Return Registers: n/a 

AH = 0Eh 


Conflicts: VMiX (chapter 17), 
See Also: Functions 0Dh and 20h, TopView Function 10h Subfunction 1Ch 


INTERRUPT 15h - Function OFh 
EXECUTE A MULTIDOS PLUS COMMAND 


Purpose: Request that the specified string be executed as if it had been typed at the MultiDOS command prompt by 
the user. 


Available on: All machines. Restrictions: MultiDOS Plus must be running. 
Registers at call: Return Registers: 
AH = 0Fh after command has been processed 


DS:BX -> ASCIZ command 

Details: The task is placed on a queue which MultiDOS examines periodically and is suspended until MultiDOS has 
processed the command. All lowercase characters up to the first blank are converted to upper case within the given 
buffer. 

Conflicts: System - Format Unit Periodic Interrupt (chapter 6), VMiX (chapter 17). 


INTERRUPT 15h - Function 10h 
TEST RESOURCE SEMAPHORE 


Purpose: Determine whether a non-shareable resource is currently in use. 


Available on: All machines. Restrictions: MultiDOS Plus must be running. 
Registers at call: Return Registers: 

AH = 10h AH = status 

AL = semaphore number (00h-3Fh) 00h semaphore not in use 


Olh semaphore owned by another task 
02h invalid semaphore number 
03h semaphore owned by caller 
Conflicts: VMiX (chapter 17). 
See Also: Functions 02h, 0Dh, and 1Dh 
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INTERRUPT 15h - Function 11h 
TURN OFF AltZ TOGGLE 


Purpose: Disable the Alt-Z command/program-selection hotkey which allows the user to switch between programs 
and the MultiDOS command prompt. 


Available on: All machines, Restrictions: MultiDOS Plus must be running. 
Registers at call: Return Registers: n/a 
AH = 11h 


Conflicts: Topview commands (chapter 15), VMiX (chapter 17). 
See Also: Function 12h 


INTERRUPT 15h - Function 12h 
TURN ON AltZ TOGGLE 


Purpose: Enable the Alt-Z command/program-selection hotkey which allows the user to switch between programs 
and the MultiDOS command prompt. 


Available on: All machines. Restrictions: MultiDOS Plus must be running. 
Registers at call: Return Registers: n/a 
AH = 12h 


Details: Enables the Alt-Z MultiDOS command/program-selection hotkey. 
Conflicts: VMiX (chapter 17), 
See Also: Function | 1h 


INTERRUPT 15h - Function 13h 


GET TASK CONTROL BLOCK 

Purpose: Determine address of data block for the calling task. 

Available on; All machines. Restrictions: MultiDOS Plus must be running. 
Registers at call: Return Registers: 

AH = 13h BX:AX -> task control block (Table 16-1) 


Conflicts: VMiX (chapter 17). 
See Also: Function [5h 


Table 16-1. Format of MultiDOS Plus v4.0 Task Control Block: 


Offset Size Description 

00h DWORD pointer to next TCB 

04h 8BYTEs ASCIZ task name 

0Ch 2BYTEs unknown. 

OEh WORD task PSP segment 

10h WORD abort/suspend flags 

12h WORD current screen segment (see Functions 0Bh,OCh) 
14h WORD _ priority level (0000h-FFFEh) 

16 WORD time slice counter 

18) 2BYTEs unknown, 

TAh WORD suspend timer value 

1Ch WORD stack segment 

18] WORD stack pointer 

20h WORD display type 

221 WORD display memory 

24h 2BYTEs unknown. 

26h WORD termination count 

28h WORD equipment flag for BIO10 driver 
2Ah BYTE background CRT mode 

2Bh WORD screen width in columns 

2Dh WORD screen size in bytes 

2F WORD segment of physical screen memory 
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Table 16-1. Format of MultiDOS Plus v4.0 task control block (continued) 








Offset Size Description 

31h 16 BYTEs eight cursor positions 

4th WORD current cursor shape 

43h BYTE active display page 

44h WORD CRT controller I/O port base 

46h 2BYTEs unknown. 

48h WORD foreground task flag 

4Ah 6BYTEs unknown. 

50h WORD saved video segment (see Functions OBh,OCh) 
52h DWORD old INT 22 

56h DWORD old INT 23 

5Ah DWORD old INT 24 

5Eh WORD top of memory for task 

601 4BYTEs unknown. 

64 WORD DTA segment (see INT 21h Function 1Ah in chapter 8) 
66h WORD DTA offset 

68 4BYTEs unknown. 

6Ch BYTE current ANSLSYS attribute 

6Dh BYTE current ANSISYS column 

6Eh BYTE current ANSLSYS row 

6Fh BYTE current ANSLSYS display state 
70h BYTE maximum ANSI.SYS columns 
7h BYTE current ANSLSYS page 

72h WORD saved ANSISYS cursor position 
74h BYTE ANSLSYS parameter buffer index 
75 BYTE current ANSILSYS screen mode 
76) BYTE ANSLSYS wrap flag 

77 6BYTEs ANSISYS parameter buffer 

7Dh BYTE ANSLSYS keyboard DSR state 
7E 7BYTEs ANSISYS keyboard DSR buffer 
85h 3BYTEs unknown. 

88h 16 BYTEs request header for DOS driver calls 
98h 14BYTEs unknown. 

AGh WORD segment of EMS map if EMS task 
A8h WORD flag: task makes EMS calls 

AAh WORD EMS handle for task 

ACh WORD keyboard shift state 

AEh 12 BYTEs unknown. 

BAh WORD TCB of parent if child task 

BCh WORD termination code 

BEh WORD COM port number 

COh 4BYTEs unknown. 

C4h WORD current IRQ number 

C6h 2BYTEs unknown. 

C8h WORD miscellaneous flag word 

CAh 2BYTEs unknown. 

CCh DWORD _ old INT 10 

DOh WORD EMS alternate map set number 
D2h 414 BYTEs DOS current disk and directory context (optional) 


INTERRUPT 15h - Function 14h 
CHECK IF MultiDOS FOREGROUND OR BACKGROUND 


Purpose: Determine whether the user is at the command prompt or in an application. 


Available on: All machines. Restrictions: MultiDOS Plus must be running. 
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Registers at call: Return Registers: 
AH = 14h AX = current state 
0000h MultiDOS Plus command prompt is 
background task 


0001h command prompt is foreground task 
Conflicts: VMixX (chapter 17). 


See Also: Function 0Bh 

INTERRUPT 15h - Function 15h 

GET SYSTEM BLOCK 

Purpose: Determine address of control record containing system-wide data. 

Available on: All machines. Restrictions: MultiDOS Plus must be running. 
Registers at call: Return Registers: 

AH = 15h BX:AX -> system block (Table 16-2) 


Conflicts: VMixX (chapter 17). 
See Also: Function 13h 


Table 16-2. Format of MultiDOS Plus 4.0 System Block: 


Offset Size Description 

00h WORD segment of system control block 

02h WORD redirection flag set by /(NOREDIRECT 

04h WORD no-INT 10 flag set by /NO10 

06h DWORD old INT 10 

OAh DWORD new INT 10 

OEh DWORD pointer to WORD with current TCB offset (see Function 13h) 
12h DWORD pointer to WORD with idle task TCB offset 

16h DWORD _ pointer to WORD with foreground TCB offset 

1Ah DWORD _ pointer to WORD with MultiDOS TCB offset 

1Eh WORD Task Control Block size 

20h WORD number of TCBs 

22h WORD flag: EMS present 

24h WORD EMS page frame base segment 

26h WORD 16K pages in EMS page frame 

28h WORD base segment for conventional memory tasks 

2Ah WORD conventional memory size in paragraphs 

2Ch DWORD pointer to list of queue pointers 

INTERRUPT 15h - Function 16h 

INITIALIZATION 

Purpose: Used internally during initialization; any other calls will cause unpredicatable results. 
Available on: All machines. Restrictions: MultiDOS Plus must be running. 
Registers at call: Return Registers: n/a 
AH = 16h 


Conflicts: VMixX (chapter 17). 


INTERRUPT 15h - Function 17h 
MAP IRQ 


Purpose: Associate the EMS memory map of the specified task control block with the indicated hardware interrupt. 


The interrupt handler will gain control with the given memory map in effect. 
Available on: All machines. Restrictions: MultiDOS Plus must be running. 
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Registers at call: Return Registers: 
AH=17h AX = status 

AL = IRQ to map (01h-OFh) 0000h successful 
BX = offset of task control block (see Function 13h) other invalid IRQ 


to associate with the IRQ 
Conflicts: VMiX (chapter 17). 
See Also: Functions 18h and 19h 


INTERRUPT 15h - Function 18h 
UNMAP IRQ 


Purpose: Remove a previously-specified association between the indicated hardware interrupt an an EMS memory 
map. 


Available on: All machines. Restrictions: MultiDOS Plus must be running. 
Registers at call: Return Registers: 
AH = 18h AX = status 
AL = IRQ to unmap (01h-OFh) 0000h successful 
0001h invalid IRQ 


Details: Results are unpredictable if the IRQ has not been mapped, 
Conflicts: VMix (chapter 17). 
See Also: Functions 17h and 19h 


INTERRUPT 15h - Function 19h 


UNMAP ALL IRQs 

Purpose: Remove all previously-specified associations between hardware interrupts and EMS memory maps. 
Available on: All machines. Restrictions: MultiDOS Plus must be running. 
Registers at call: Return Registers: 

AH=19h AX destroyed 


Details: For MultiDOS internal use only. 
Conflicts: VMixX (chapter 17). 
See Also: Functions 17h and 18h 


INTERRUPT 15h - Function 1Ah 
MAP SEMAPHORE NAME TO NUMBER 


Purpose: Create a new semaphore name and associate it with an available semaphore. 


Available on: All machines. Restrictions: MultiDOS Plus must be running. 
Registers at call: Return Registers: 

AH = {Ah AL = status 

DS:SI -> 8-byte name 00h successful 


AH = semaphore number (20h-3Fh) 
04h out of string space 
Details: All eight bytes of the name are significant. If the name does not already exist, it is added to the name table 
and associated with a free semaphore number, Names cannot be destroyed. 
Conflicts: VMix (chapter 17). 
See Also: Functions 1Bh, 1Ch, and 1Dh 


INTERRUPT 15h - Function 1Bh 
REQUEST RESOURCE SEMAPHORE BY NAME 


Purpose: Gain exclusive access to the resource with the specified name, suspending caller if necessary. 
Available on: All machines, Restrictions: MultiDOS Plus must be running. 
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Registers at call: Return Registers: 
AH = iBh AH = status 
DS:SI -> 8-byte name 00h successful 


02h invalid semaphore number 
03h caller already owns semaphore 
04h out of string space 

Details: Equivalent to Function 1Ah followed by Function Oih (see notes for Function 01h). 

Conflicts: VMiX (chapter 17). 

See Also: Functions 01h, 1Ah, !Ch, and 1Dh 


INTERRUPT 15h - Function 1Ch 
RELEASE RESOURCE SEMAPHORE BY NAME 


Purpose: Indicate that other tasks may access the non-shareable resource corresponding to the given name, 


Available on: All machines. Restrictions: MultiDOS Plus must be running. 
Registers at call: Return Registers: 

AH = 1Ch AH = status 

DS:SI -> 8-byte name 00h successful 


Oth not semaphore owner 

02h invalid semaphore number 

04h out of string space 
Details: Equivalent to Function 1Ah followed by Function 02h (see notes for Function 02h), 
Conflicts: VMiX (chapter 17). 
See Also: Functions 02h, 1Ah, 1Bh, and 1Dh 


INTERRUPT 15h - Function 1Dh 
TEST RESOURCE SEMAPHORE BY NAME 


Purpose: Determine whether the resource corresponding to the specified name is in use. 


Available on: All machines. Restrictions: MultiDOS Plus must be running. 
Registers at call: Return Registers: 

AH = IDh AH = status 

DS:SI -> 8-byte name 00h semaphore not in use 


Oh semaphore owned by another task 
02h invalid semaphore number 
03h caller owns semaphore 
04h out of string space 
Details: Equivalent to Function 1Ah followed by Function 10h. (see notes for Function 10h) 
Conflicts: VMiX (chapter 17). 
See Also: Functions 10h, 1Ah, 1Bh, and 1Ch 


INTERRUPT 15h - Function 1Eh, Subfunction 00h 
CLEAR EVENT COUNTER 


Purpose: Discard any pending events on the specified counter, 


Available on: All machines. Restrictions: MultiDOS Plus must be running. 
Registers at call: Return Registers: 

AX = 1E00h AH = status 

DX = event/trigger number (OOh-3Fh) 00h successful 


Conflicts: VMiX (chapter 17). 
See Also: Function 1Eh Subfunctions 01h and 02h 


INTERRUPT 15h - Function 1Eh, Subfunction O1h 
TRIGGER EVENT 


Purpose: Restart any task waiting for the specified event; if no task is waiting, the event counter is incremented (and 


will roll over if it was 65535). 
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Available on: All machines. Restrictions: MultiDOS Plus must be running. 
Registers at call: Return Registers: 

AX = 1EOlh AH = status 

DX = event/trigger number (00h-3Fh) 00h successful 


Oth invalid event/trigger number 
Details: This function may be invoked by an interrupt handler. 
Conflicts: None known. 
See Also: Function 1Eh Subfunctions 00h and 02h 


INTERRUPT 15h - Function 1Eh, Subfunction 02h 


WAIT FOR EVENT 

Purpose: Suspend until the specified event is triggered; if the event had already been triggered, return immediately. 
Available on: All machines. Restrictions: MultiDOS Plus must be running. 
Registers at call: Return Registers: 

AX = 1E02h AH = status 

DX = event/trigger number (O0h-3Fh) 00h successful 


Oh invalid event/trigger number 
Details: If the event counter is zero, the task is suspended until the event is triggered with Function 1Eh Subfunction 
OIh; else, the counter is decremented and the call returns immediately. 
Conflicts: None known. 
See Also: Function 1Eh Subfunctions 00h and 01h 


INTERRUPT 15h - Function 1Fh 


GET MEMORY PARAMETERS 

Purpose: Determine the starting addresses of conventional and EMS memory, 

Available on: All machines. Restrictions: MultiDOS Plus version 4.01 or higher 
must be running. 

Registers at call: Return Registers: 

AH = 1Fh BX = first segment of conventional memory 


DX = first segment of EMS swap frame into which 
MultiDOS will load programs 
Conflicts: None known, 


INTERRUPT 15h - Function 20h 
CHECK IF MULTITASKING ENABLED 


Purpose: Determine whether MultiDOS is currently time-slicing, and if not, who disabled the time-slicing. 


Available on: All machines. Restrictions: MultiDOS Plus version 4.01 or higher 
must be running. 

Registers at call: Return Registers: 

AH = 20h AX = current state 


0000h multitasking enabled 

other TCB of task that disabled multitasking 
Conflicts: SYSREQ Routine (chapter 3), 
See Also: Functions ODh and 13h 
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Other Multitaskers and Task Switchers 





Microsoft Windows, TopView, DESQview, and MultiDOS were covered in chapters 14 through 16; Alloy 386/Multi- 
Ware is in chapter 18 because it includes both multitasking and networking. This chapter contains the remainder of 
the multitaskers and task switchers on which we have information: Backé&Forth, Cswitch, CTask, DoubleDOS, Multi- 
Link, Omniview, and VMixX, 

Back&Forth is a task switcher by Progressive Solutions (Sandi and Shane Stump). 

CTask and Cswitch are primarily designed to provide multitasking within single programs, CTask is public do- 
main software by Thomas Wagner, while Cswitch was written by Herb Rose. 

DoubleDOS by Softlogic Solutions, Inc. permits two programs to run concurrently. 

Omniview by Sunny Hill Software is a TopView-compatible multitasker, see chapter 15 for the TopView calls. 

VMix is a shareware multiuser multitasker by Commercial Software Associates (ComSoft). Recent versions are 
able to run an 80386 in Virtual-86 mode; all versions have been able to make use of 80286 protected mode for much 


of VMixX’s operation. 


INTERRUPT 11h - Function FFh, Subfunction FEh 


Back&Forth API 

Purpose: Determine whether Back&Forth is running; if so, permit communication with it. 

Available on: All machines. Restrictions: Back&Forth prior to version 1.62 must 
be installed for functions other than the 
installation check. 

Registers at call: Return Registers: 

AX = FFFEh AX = 0001h BNFHIGH and BNFLOW both loaded 

CX = FFFEh = 0003h only BNFHIGH loaded 

BX = function else neither loaded 

00h installation check 
Oth unknown. DX:AX - > unknown. 
02h unknown. nla 


03h unknown. 

04h unknown. 

05h unknown. switches current PSP segment and 

stack if BNFLOW has not yet announced itself 

installed, 

06h unknown. AX = unknown. 
Conflicts: BIOS interface (chapter 3). 
See Also: INT 12h Function FFh Subfunction FEh 


INTERRUPT 12h - Function FFh, Subfunction FEh 


Back&Forth API 
Purpose: Determine whether Back&Forth is running, and if so, permit communication with it. 
Available on: All machines. Restrictions: Back&Forth version 1.62 or higher must 


be installed for functions other than the 
installation check. 
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Registers at call: Return Registers: 
AX = FFFEh AX = 0001h installed 
CX = FRFEh else not loaded 


BX = function 
00h installation check 


02h build program ID list AX = number of programs defined 
ES:DI -> buffer of at least 100 bytes, to be ES:DI buffer filled with AX words 
filled with words 
03h switch to specified task (task need not be AX = 0000h if task undefined 
open yet) 


DX 5 two-letter program ID 
Conflicts: BIOS Get Memory Size (chapter 3). 
See Also: INT 11h Function FFh Subfunction FEh 


INTERRUPT 15h - Function 00h 


INSTALLATION CHECK 

Purpose: Determine whether VMiX version 2.0 or higher is running, 

Available on: Ali machines. Restrictions: none. 
Registers at call: Return Registers: 
AH = 00h DX = 0798h 


Conflicts: Cassette (chapter 3), Amstrad PC1512 (chapter 4), Multidos Plus (chapter 16), 


INTERRUPT 15h - Function 01h 
YO CHANNEL OBJECT MANAGER 


Purpose: Manipulate I/O channel objects, 


Available on: All machines. Restrictions: VMiX must be running, 
Registers at call: Return Registers: 
AH = 01h DX:AX -> IRP structure or 0000h:0000h 


STACK: WORD object ID of requestor 
DWORD pointer to name of requested methad 
WORD arg] 
WORD arg2 
WORD arg3 
WORD arg4 
Conflicts: Cassette (chapter 3), Amstrad PC1512 (chapter 4), MultiDOS Plus (chapter 16). 


INTERRUPT 15h - Function 02h 


MEMORY OBJECT MANAGER 

Purpose: Manipulate memory objects. 

Available on: All machines. Restrictions: VMiX must be running, 
Registers at call: Return Registers: 

AH =02h DX-:AX = pointer to memory block 


STACK: WORD object ID of requestor DWORD 
pointer to name of requested method 
WORD argl 
WORD arg2 
WORD arg3 
WORD arg4 
WORD arg5 
Conflicts: Cassette (chapter 2), Amstrad PC1512 (chapter 4), MultiDOS Plus (chapter 16), 
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INTERRUPT 15h - Function 03h 


PROMPTED CONSOLE INPUT 

Purpose: Request input from the user. 

Available on: All machines. Restrictions: VMiX must be running. 

Registers at call: Return Registers: 

AH = 03h AX = length of input (input buffer is padded with 
STACK: DWORD pointer to ASCII prompt blanks) 


WORD __ field outline character 
WORD length of input field 
DWORD address of pointer to input 
buffer 
WORD number of characters input 
Conflicts: Cassette (chapter 3), Amstrad PC1512 (chapter 4), MultiDOS Plus (chapter 16). 


INTERRUPT 15h - Function 04h 


VPRINTF 

Purpose: Display a string with varying arguments. 

Available on: All machines. Restrictions: VMiX must be running. 
Registers at call: Return Registers: n/a 

AH = 04h 


STACK: DWORD control string 
DWORD array of arguments 
Conflicts: System (PS) Build ABIOS System Parameter Table (chapter 3), Amstrad PC1512 (chapter 4). 


INTERRUPT 15h - Function 05h 
GET PROCESS ID OF CURRENT PROCESS 


Purpose: Determine calling program's process identifier. 


Available on: All machines. Restrictions; VMiX must be running. 

Registers at call: Return Registers: 

AH = 05h AX = process ID 

Conflicts: MultiDOS Plus (chapter 16), System - Build ABIOS Initialisation Table (chapter 3), Amstrad PC1512 
(chapter 4). 


See Also: Functions 06h and OBh 


INTERRUPT 15h - Function 06h 
GET POINTER TO PROCESS CONTROL BLOCK 


Purpose: Determine the address of the control block for calling program. 


Available on: All machines. Restrictions: VMiX must be running. 
Registers at call: Return Registers: 
AH = 06h DX:AX -> process control block 


STACK: WORD process ID 
Conflicts; Amstrad PC1512 (chapter 4), MultiDOS Plus (chapter 16). 
See Also: Functions 07h and 08h 


INTERRUPT 15h - Function 07h 
GET POINTER TO OBJECT CONTROL BLOCK 


Purpose: Determine the address of the control block for a specified object type. 


Available on: All machines. Restrictions: VMiX must be running. 
Registers at call: Return Registers: 
AH = 07h DX:AX -> object control block 


STACK: WORD object type 
Conflicts: MultiDOS Plus (chapter 16). 
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See Also: Functions 06h and 08h 


INTERRUPT 15h - Function 08h 
GET CHANNEL CONTROL BLOCK 


Purpose: Determine the address of the control block for a specified I/O channel. 


Available on: All machines. Restrictions: VMiX must be running. 
Registers at call: Return Registers: 
AH = 08h DX:AX -> channel control block 


STACK: WORD channel ID 
Conflicts: MultiDOS Plus (chapter 16). 
See Also: Functions 06h and 07h 


INTERRUPT 15h - Function 09h 


GET ID OF QUEUED ELEMENT 

Purpose: Determine the identifier of the first item in the specified queue. 

Available on: All machines. Restrictions: VMiX must be running. 
Registers at call: Return Registers: 

AH = 09h AX =ID 


STACK: WORD queue ID (0 = process queue, 1 = 
object, 3 = type) 
WORD subqueue ID 
Conflicts: MultiDOS Plus (chapter 16). 
See Also: Function 0Ah 


INTERRUPT 15h - Function 0Ah 
GET ID OF NEXT QUEUED ELEMENT 


Purpose: Determine the identifier of the next item in the specified queue. 


Available on: All machines. Restrictions: VMiX must be running, 
Registers at call: Return Registers: 
AH = 0Ah AX = ID of next element 


STACK: WORD queue ID (0 = process queue, | = 
object, 3 = type) 
WORD ID of current element in queue chain 
Conflicts: MultiDOS Plus (chapter 16), 
See Also: Functions 09h and OFh 


INTERRUPT 15h - Function 0Bh 
GET TOTAL NUMBER OF ACTIVE PROCESSES 


Purpose: Determine how many processes are currently active in the system. 


Available on: All machines, Restrictions: VMiX must be running. 
Registers at call: Return Registers: 
AH = 0Bh AX = number of active processes 


Conflicts: MultiDOS Plus (chapter 16). 
See Also: Functions 05h and OEh 


INTERRUPT 15h - Function 0Ch 
GET POINTER TO PROCESS TSS STACK 


Purpose: Determine the address of the hardware task-switching stack for the specified process. 


Ayailable on: All machines. Restrictions: VMiX must be running. 
Registers at call: Return Registers: 
AH =0Ch DX-AX -> TSS stack store 


STACK: WORD process ID 
Conflicts: MultiDOS Plus (chapter 16). 
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INTERRUPT 15h - Function 0Dh 
START A CHILD PROCESS JOB SHELL 


Purpose: Initiate a new shell with its own process. 


Available on: All machines. Restrictions: VMiX must be running. 
Registers at call: Return Registers: 
AH =0Dh AX = status 


STACK: DWORD ASCIZ string starting with 
requested I/O channel and followed by standard 
VMiX shell command string 

Conflicts: MultiDOS Plus (chapter 16). 


See Also: Function 0Eh 

INTERRUPT 15h - Function 0Eh 

TERMINATE PROCESS 

Purpose: Permanently stop a process and deallocate its resources. 

Available on: All machines. Restrictions: VMiX must be running. 
Registers at call: Return Registers: 

AH = 0Eh AX = status 


STACK: WORD process ID 
Conflicts: MultiDOS Plus (chapter 16). 
See Also: Functions OBh and 0Dh 


INTERRUPT 15h - Function 0Fh 
GET KEY FIELD OF QUEUED ELEMENT 


Purpose: Determine the key value of the specified element in the indicated queue. 


Available on: All machines. Restrictions: VMiX must be running. 
Registers at call: Return Registers: 
AH = 0Fh AX = key 


STACK: WORD queue ID 
(0 = process queue, 1 = object q, 3 = type q) 
WORD ID of element in queue chain 
Conflicts: System - Format Unit Periodic Interrupt (chapter 3), MultiDOS Plus (chapter 16). 
See Also: Function 0Ah 


INTERRUPT 15h - Function 10h 
EXECUTE FUNCTION IN PROTECTED MODE 


Purpose: Call a subroutine running in protected mode. 


Available on: All machines. Restrictions: VMiX must be running. 
Registers at call: Return Registers: unknown. 
AH = 10h 


STACK: DWORD pointer to function 
N WORDs function args 
Conflicts: DESQview (chapter 15), TopView (chapter 15), MultiDOS Plus (chapter 16). 


INTERRUPT 15h - Function 11h 

EXECUTE SHELL SYSTEM COMMANDS 

Purpose: Perform the command contained in a string as though the user had entered it at the VMixX prompt 
Available on: All machines. Restrictions: VMiX must be running. 
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Registers at call: Return Registers: 
AH = 1th AX = status 
STACK: DWORD pointer to an ASCIZ string 
containing a VMiX shell request (max length = 
127) 
Conflicts: DESQview (chapter 15), Topview (chapter 15), MultiDOS Plus (chapter 16). 


INTERRUPT 15h - Function 12h 


PUT PROCESS TO SLEEP 

Purpose: Suspend the specified process until it is explicitly restarted, 

Available on: All machines. Restrictions: VMiX must be running. 
Registers at call: Return Registers: 

AH = 12h AX = status 


STACK: WORD process ID 
Conflicts: DESQview (chapter 15), Top View (chapter 15), MultiDOS Plus (chapter 16), 
See Also: Function 13h, MultiDOS Function 03h (chapter 16), TopView Function 10h Subfunction 1Dh (chapter 15) 


INTERRUPT 15h - Function 13h 


WAKE PROCESS 

Purpose: Restart a previously-suspended process. 

Available on: All machines, Restrictions: VMiX must be running. 
Registers at call: Return Registers: 

AH = 13h AX = status 


STACK: WORD process ID 
Conflicts: MultiDOS Plus (chapter 16). 
See Also: Function [2h 


INTERRUPT 15h - Function 14h 


CLEAR WINDOW 

Purpose: Fill the specified portion of the display with blanks. 

Available on: All machines. Restrictions: VMiX must be running, 
Registers at call: Return Registers: 

AH = 14h AX = status 


STACK: WORD top left corner of window 
WORD bottom right comer of window 
Conflicts: MultiDOS Plus (chapter 16). 
See Also: Function 15h 


INTERRUPT 15h - Function 15h 
SET BANNER WINDOW MESSAGE 


Purpose: Specify the message to be displayed in the banner window. 


Available on: All machines. Restrictions: VMiX must be running. 
Registers at call: Return Registers: 
AH = 15h AX = status 
STACK: DWORD pointer to ASCIZ banner 
message 


Conflicts: MultiDOS Plus (chapter 16). 
See Also: Function 14h 


INTERRUPT 15h - Function 16h 
SET ROOT WINDOW SIZE AND HOME CURSOR 


Purpose: Specify the size of the root window and move the cursor to its new upper left corner. 
Available on: All machines. Restrictions: VMiX must be running. 
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Registers at call: Return Registers: 
AH = 16h AX = status 
STACK: DWORD pointer to I/O Request Packet 

WORD top left corner of window 

WORD bottom right corner of window 

Conflicts: MultiDOS Plus (chapter 16). 

See Also: Function 17h 


INTERRUPT 15h - Function 17h 
GET CONSOLE WINDOW COLORS 


Purpose: Determine the colors used by the console window. 


Available on: All machines. Restrictions: VMiX must be running. 
Registers at call: Return Registers: 
AH = 17h AH = foreground color 


AL = background color 
Conflicts: MultiDOS Plus (chapter 16). 
See Also: Functions 16h and 18h 


INTERRUPT 15h - Function 18h 


SET CONSOLE COLORS 
Purpose: Specify the colors to be used by the console window. 
Available on: All machines. Restrictions: VMiX must be running. 
Registers at call: Return Registers: 
AH = 18h AX = color 
STACK: WORD new background/foreground 
colors 


Conflicts: MultiDOS Plus (chapter 16). 
See Also: Function 17h 


INTERRUPT 15h - Function 19h 


Unknown Function 

Purpose: unknown. 

Available on: All machines. Restrictions: VMiX version 2.0 or higher must be 
running. 

Registers at call: Return Registers: unknown. 

AH = 19h 

STACK: WORD unknown. 

Conflicts: MultiDOS Plus (chapter 16). 

INTERRUPT 15h - Function 1Ah 

Unknown Function 

Purpose: unknown. 

Available on: All machines, Restrictions: VMiX version 2.0 or higher must be 
running. 

Registers at call: Return Registers: unknown. 

AH = 1Ah 


STACK; 3 WORDs unknown. 
Conflicts: MultiDOS Plus (chapter 16). 


INTERRUPT 15h - Functions 1Bh and 1Ch 
Unknown Functions 


Purpose: unknown. 
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Available on: All machines. Restrictions: VMiX version 2.0 or higher must be 
running. 
Registers at call: Return Registers: unknown. 


AH = 1Bh or 1Ch 
STACK: 5 WORDs unknown. 
Conflicts: MultiDOS Plus (chapter 16). 


INTERRUPT 15h - Function 1Dh 


Unknown Function 

Purpose: unknown. 

Available on: All machines. Restrictions: VMiX version 2.0 or higher must be 
running. 

Registers at call: Return Registers: unknown. 

AH=1Dh 

other unknown, 

Conflicts: MultiDOS Plus (chapter 16). 

INTERRUPT 15h - Function 1Eh 

Unknown Function 

Purpose: unknown. 

Available on: Ali machines. Restrictions: VMiX version 2.0 or higher must be 
running. 

Registers at call: Return Registers: unknown. 

AH = IEh 


STACK: WORD uarknown. 
Conflicts: MultiDOS Plus (chapter 16). 


INTERRUPT 15h - Function 54h, Subfunction 00h 
Omniview INSTALLATION NOTIFICATION 


Purpose: Called by Omniview on startup to allow any interested programs loaded before Omniview to perform 
whatever preparations are needed for operation under Omniview. 


Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: unknown. 
AX = 5400h 


ES:BX -> device information tables 
DLDX -> dispatcher entry point 
Conflicts: None known, 

See Also: Function 54h Subfunction 07h 


INTERRUPT 15h - Function 54h, Subfunction 01h 


PROCESS CREATION 

Purpose: Called by Omniview on creating a new, independent process. 

Available on: All machines. Restrictions: Omniview must be running. 
Registers at call: Return Registers: unknown. 

AX = 540Ih 


ES:BX = process handle 
Conflicts: None known. 
See Also: Function 54h Subfunction 02h 


INTERRUPT 15h - Function 54h, Subfunction 02h 
PROCESS DESTRUCTION 


Purpose: Called by Omniview when it terminates a process and deallocate its resources. 
Available on: All machines, Restrictions: Omniview must be running. 
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Registers at call: Return Registers: unknown. 
AX = 5402h 

ES:DX = process handle 

Conflicts: None known. 

See Also: Function 54h Subfunction 01h 


INTERRUPT 15h - Function 54h, Subfunction 03h 
SAVE STATE 


Purpose: Called by Omniview to inform interested programs that they should save their current state in preparation 
for a task switch. 


Available on: All machines. Restrictions: Omniview must be running. 
Registers at call: Return Registers: unknown. 
AX = 5403h 


ES:DX = process swapping out 
Conflicts: None known. 
See Also: Function 54h Subfunction 04h 


INTERRUPT 15h - Function 54h, Subfunction 04h 
RESTORE STATE 


Purpose: Called by Omniview to inform interested programs that they should restore a previously saved state after a 
task switch, 


Available on: All machines. Restrictions: Omniview must be running. 
Registers at call: Return Registers: unknown. 
AX = 5404h 


ES:DX = process swapping in 
Conflicts: None known. 
See Also: Function 54h Subfunction 03h 


INTERRUPT 15h - Function 54h, Subfunction 05h 
SWITCHING TO BACKGROUND 


Purpose: Called by Omniview to inform interested programs that it is placing itself in the background. 


Available on: All machines, Restrictions: Omniview must be running. 
Registers at call: Return Registers: unknown, 
AX = 5405h 


ES:DX = process swapping in 
Conflicts: None known. 
See Also: Function 54h Subfunction 06h 


INTERRUPT 15h - Function 54h, Subfunction 06h 
SWITCHING TO FOREGROUND 


Purpose: Called by Omniview to inform interested programs that it is placing itself in the foreground. 


Available on; All machines. Restrictions: Omniview must be running. 
Registers at call: Return Registers: unknown. 
AX = 5406h 


ES:DX = process swapping in 
Conflicts: None known. 
See Also: Function 54h Subfunction 05h 


INTERRUPT 15h - Function 54h, Subfunction 07h 

EXIT NOTIFICATION 

Purpose: Called by Omniview to allow any interested programs to perform whatever cleanup is necessary for 
resuming normal DOS operation. 

Available on: All machines. Restrictions: Omniview must be running. 
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Registers at call: Return Registers: unknown. 
AX = 5407h 

Conflicts: None known. 

See Also: Function 54h Subfunction 00h 


INTERRUPT 21h - Function 30h, Subfunction 00h 
CTask INSTALLATION CHECK 


Purpose: Determine whether CTask multitasker version 2.0 or higher is installed. 
Available on: All machines. Restrictions: none. 
Registers at call: 
AX = 3000h 
BX = 1234h 
DS:DX -> 8-byte version string (DX < FFFOh) 
"“CTask21", OOh for v2.1-2.2 
Return Registers: 
AL = DOS major version 
AH = DOS minor version 
CX:BX -> Ctask global data block 
Details: If the first eight bytes of returned data block equal the eight bytes passed in, CTask is resident. CTask is a 
multitasking kernel for C written by Thomas Wagner. 
Conflicts: DOS 2+ Get DOS Version (chapter 8), Phar Lap 386/DOS-Extender (chapter 9), "Dutch-555" virus 
(chapter 34). 


INTERRUPT 21h - Function E0h 
MENU CONTROL 


Purpose: Perform actions which a user is able to request at the DoubleDOS menu. 
Available on: All machines. Restrictions: DoubleDOS must be running. 
Registers at call: Return Registers: n/a 
AH = E0h 
AL = subfunction 
Olh exchange tasks 
73h resume invisible job if suspended 
74h kill other job 
75h suspend invisible job 
Details: This function is identical to Function FOh. 
Conflicts: OS/286, OS/386 (chapter 1), Alloy NINX (chapter 18), Novell NetWare (chapter 20), "Jerusalem", 
“Armagedon", and "8-tunes" viruses (chapter 34), 
See Also: Function FOh 


INTERRUPT 21h - Function Eth 
CLEAR KEYBOARD BUFFER FOR CURRENT JOB 


Purpose: Discard any pending keystrokes. 


Available on: All machines. Restrictions: DoubleDOS must be running. 
Registers at call: Return Registers: n/a 
AH = Eth 


Details: This function is identical to Function Fih. 

Conflicts: OS/286, OS/386 (chapter 1), Novell NetWare (chapter 20), "Mendoza", "Fu Manchu" viruses (chapter 
34). 

See Also: Functions E2h, E3h, and E8h 


INTERRUPT 21h - Function E2h 
SEND CHARACTER TO KEYBOARD BUFFER OF OTHER JOB 


Purpose: Supply fake keyboard input to the other program running under DoubleDOS. 
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Available on: All machines. Restrictions: DoubleDOS must be running. 
Registers at call: Return Registers: 

AH =E2h AL = 00h successful 

AL = character Olh buffer full (128 characters) 


Conflicts: 05/286, OS/386 (chapter 1), Alloy NTNX (chapter 18), Novell NetWare (chapter 20). 
See Also: Functions Eih, E3h, E8h, and F2h 


INTERRUPT 21h - Function E3h 
ADD CHARACTER TO KEYBOARD BUFFER OF CURRENT JOB 


Purpose: Store a keystroke for later retrieval as if the user had pressed it. 


Available on: All machines, Restrictions: DoubleDOS must be running. 
Registers at call: Return Registers: 

AH = E3h AL = 00h successful 

AL = character Oth buffer full (128 characters) 


Conflicts: Alloy NTNX (chapter 18), Novell NetWare (chapter 20). 
See Also: Functions Elh, E2h, E8h, and F3h 


INTERRUPT 21h - Function E4h, Subfunction 00h 
INSTALLATION CHECK/PROGRAM STATUS 


Purpose: Determine whether DoubleDOS is running, and if so, which partition the caller is in, 


Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AX = E400h AL = 00h if DoubleDOS not present 


= Olh if running in visible DoubleDOS partition 
= 02h if running in invisible DoubleDOS partition 
Conflicts: Novell NetWare (chapter 20), "Anarkia” virus (chapter 34). 
See Also: Functions E5h and F4h 


INTERRUPT 21h - Function E5h 


OTHER PROGRAM STATUS 

Purpose: Determine whether there is another program loaded under DoubleDOS, and if so, whether it is current 
running. 

Available on: All machines. Restrictions: DoubleDOS must be running. 

Registers at call: Return Registers: 

AH = E5h AL = 00h no program in other partition 


= O1h program in other partition is running 

= 02h program in other partition is suspended 
Conflicts: Novell NetWare (chapter 20). 
See Also: Function E4h Subfunction 00h, Function FSh 


INTERRUPT 21h - Function E8h 
SET/RESET KEYBOARD CONTROL FLAGS 


Purpose: Specify which keyboard actions the user is allowed to perform. 


Available on: All machines. Restrictions: DoubleDOS must be running, 
Registers at call: Return Registers: 
AH = E8h DX = previous flags 


AL = 00h set flags for this program 
= O1h set flags for other program 
DX = keyboard control flags (bit set enables, 
cleared disables) 
bit 0: menu 
bit 1: exchange 
bit 2: entire keyboard enable/disable 
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bit 3: Ctrl-C 

bit 4: Ctrl-PriSe 

bit 5: Alt/Erase 

bit 6: Ctrl-Break 

bit 7: Ctrl-NumLock 

bit 8: shift-PrtSc 

bit 9-13: undefined 

bit 14: cancel key (clear keyboard buffer) 

bit 15: suspend key 
Details: Disabling Ctrl-PréSc will allow the program to intercept the keystroke; disabling any of the other keystrokes 
disables them completely. 
Conflicts: Alloy NTNX (chapter 18), Novell NetWare (chapter 20). 
See Also: Functions Elh, E2h, E3h, and F8h. 


INTERRUPT 21h - Function E9h 
SET TIMESHARING PRIORITY 


Purpose: Specify the percentage of CPU time each program gets. 


Available on: All machines, Restrictions: DoubleDOS must be running. 
Registers at call: Return Registers: 
AH=E9h AL = priority setting (function 05h) 


AL = 00h visible program gets 70 
invisible gets 30 (default) 
= 01h visible program gets 50 
invisible gets 50 
= 02h visible program gets 30 
invisible gets 70 
= 03h Top program gets 70 
bottom program gets 30 
= 04h Top program gets 30 
bottom program gets 70 
= 05h get current priority 
Conflicts: Alloy NTNX (chapter 18), Novell NetWare (chapter 20). 
See Also: Functions EAh, EBh, and F9h 


INTERRUPT 21h - Function EAh 
TURN OFF TASK SWITCHING 


Purpose: Temporarily suspend multitasking so that the calling program may execute time-critical or nonreentrant 
code. 


Available on: All machines. Restrictions: DoubleDOS must be running. 
Registers at call: Return Registers: 
AH=EAh task switching turned off 


Conflicts: Alloy NTNX (chapter 18), Novell NetWare (chapter 20). 
See Also: Functions E9h, EBh, and FAh, INT FAh 


INTERRUPT 21h - Function EBh 


TURN ON TASK SWITCHING 

Purpose: Reenable multitasking after the calling program completes time-critical or nonreentrant code. 
Available on: All machines. Restrictions: DoubleDOS must be running. 
Registers at call: Return Registers: 

AH =EBh task switching turned on 


Conflicts: Alloy NTNX (chapter 18), Novell NetWare (chapter 20). 
See Also: Functions E9h, EAh, and FBh, INT FBh 
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INTERRUPT 21h - Function ECh 
GET VIRTUAL SCREEN ADDRESS 


Purpose: Determine the address of the memory to use instead of the physical display memory. 


Available on: All machines. Restrictions: DoubleDOS must be running. 
Registers at call: Return Registers: 
AH =ECh ES = segment of virtual screen 


Details: The screen address can change if task-switching is on. 
Conflicts: Alloy NTNX (chapter 18), Novell NetWare (chapter 20), "Terror" virus (chapter 34). 
See Also: Function FCh, INT FCh 


INTERRUPT 21h - Function EEh 
GIVE AWAY TIME TO OTHER TASKS 


Purpose: Indicate to DoubleDOS that the program is idle and that the CPU time it would normally receive may be 
given to the other program. 


Available on: All machines. Restrictions: DoubleDOS must be running. 
Registers at call: Return Registers: 
AH =EEh returns after giving away time slices 


AL = number of 55ms time slices to give away 
Conflicts: Alloy NTNX (chapter 18), Novell NetWare (chapter 20), “Jerusalem-G" virus (chapter 34). 
See Also: Function FEh, INT FEh 


INTERRUPT 21h - Functions FOh through FEh 


DoubleDOS 

Purpose: These functions are identical to DoubleDOS functions E0h through EEh (see above). 
Available on: All machines. Restrictions: DoubleDOS must be running. 
Registers at call: Return Registers: 

varies by function varies by function 


Conflicts: Novell NetWare (chapter 20), "Frere Jacques", "Flip", "2468", and "Black Monday" viruses (chapter 34), 
PC Magazine PCMANAGE/DCOMPRES (chapter 36). 
See Also: Functions E0h through EEh 


INTERRUPT 62h - Function 01h 
GIVE UP REST OF TIME SLICE 


Purpose: Indicate to Cswitch that the caller is idle and the remainder of its time slice may be given to other 


programs. 
Available on: All machines. Restrictions: Cswitch must be installed. 
Registers at call: Return Registers: n/a 

AH = 0th 


Details: Cswitch is a set of multitasking functions by Herb Rose. 
Conflicts: MS SQL Server/Sybase DBLIBRARY (chapter 27), PC Tools 7 COMMUTE (chapter 33). 
See Also: Functions 05h and 06h 


INTERRUPT 62h - Function 02h 


WAIT FOR SEMAPHORE 

Purpose: Suspend calling task until the specified resource is available, 

Available on: All machines. Restrictions: Cswitch must be installed. 
Registers at call: Return Registers: 

AH = 02h AX = FFFFh bad semaphore number 
DX = semaphore number (0-63) else success 


Conflicts: MS SQL Server/Sybase DBLIBRARY (chapter 27), PC Tools 7 COMMUTE (chapter 33), 
See Also: Functions 03h and 04h 
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INTERRUPT 62h - Function 03h 


CHECK SEMAPHORE 

Purpose: Determine whether the specified resource is in use. 

Available on: Ali machines. Restrictions: Cswitch must be installed. 
Registers at call: Return Registers: 

AH =03h AX = FFFFh not owned 

DX = semaphore number (0-63) else owned 


Conflicts: MS SQL Server/Sybase DBLIBRARY (chapter 27), PC Tools 7 COMMUTE (chapter 33), 
See Also: Functions 02h and 04h 


INTERRUPT 62h - Function 04h 


TRIGGER SEMAPHORE 

Purpose: Indicate that the specified resource is now available for use. 

Available on: All machines. Restrictions: Cswitch must be installed. 
Registers at call: Return Registers: 

AH = 04h AX = FFFFh bad semaphore number 
DX = semaphore number (0-63) "else success 


Conflicts: MS SQL Server/Sybase DBLIBRARY (chapter 27), PC Tools 7 COMMUTE (chapter 33). 
See Also: Functions 02h and 03h 


INTERRUPT 62h - Function 05h 


SLEEP 

Purpose: Suspend the calling task for the indicated period of time. 

Available on: All machines. Restrictions: Cswitch must be installed. 
Registers at call: Return Registers: n/a 

AH =05h 


BX = seconds to sleep 
Conflicts: MS SQL Server/Sybase DBLIBRARY (chapter 27), PC Tools 7 COMMUTE (chapter 33). 
See Also: Functions 01h, 06h, and 08h 


INTERRUPT 62h - Function 06h 


SUSPEND 

Purpose: Suspend the calling task until it is explicitly restarted. 

Available on: All machines. Restrictions: Cswitch must be installed. 
Registers at call: Return Registers: n/a 

AH = 06h 


Conflicts: MS SQL Server/Sybase DBLIBRARY (chapter 27), PC Tools 7 COMMUTE (chapter 33). 
See Also: Functions 05h and 08h 


INTERRUPT 62h - Function 07h 


SPAWN 
Purpose: Create a new thread of execution. 
Available on: All machines. Restrictions: Cswitch must be installed. 
Registers at call: Return Registers: 
AH=07h AX=FFFDh no free memory control blocks 
ES:BX -> function address to start executing at = FFFEh no free task control blocks 
CX = priority (1-10) = FFFFh not enough memory to create new task 
stack 
= >0 the tcb number of the new task, 


indicating no error 
Conflicts: MS SQL Server/Sybase DBLIBRARY (chapter 27), PC Tools 7 COMMUTE (chapter 33). 
See Also: Functions OFh and 10h 
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INTERRUPT 62h - Function 08h 


WAKE UP TASK 

Purpose: Restart a task which previously suspended itself. 

Available on: All machines. Restrictions: Cswitch must be installed. 
Registers at call: Return Registers: n/a 

AH = 08h 


BX = tcb identifier 
Conflicts: MS SQL Server/Sybase DBLIBRARY (chapter 27), PC Tools 7 COMMUTE (chapter 33). 
See Also: Functions 05h and 06h 


INTERRUPT 62h - Function 09h 


SET PRIORITY 

Purpose: Specify the relative importance of the calling task. 

Available on: All machines. Restrictions: Cswitch must be installed, 
Registers at call: Return Registers: n/a 

AH = 09h 


BX = new base priority (1-10) 
Details: The lower the priority is numerically, the more often the task will run. 
Conflicts: MS SQL Server/Sybase DBLIBRARY (chapter 27), PC Tools 7 COMMUTE (chapter 33). 


INTERRUPT 62h - Function 0Ah 


TEST MESSAGE QUEUE 
Purpose: Determine whether any messages are available in the specified queue. 
Available on: All machines. Restrictions: Cswitch must be installed, 
Registers at call: Return Registers: 
AH = 0Ah AX = FFFFh bad queue number 
DX = queue number (0-63) = 0000h nothing on queue 
else number of bytes in first message in 
queue 


Conflicts: MS SQL Server/Sybase DBLIBRARY (chapter 27), PC Tools 7 COMMUTE (chapter 33). 
See Also: Functions OBh and 0Ch 


INTERRUPT 62h - Function OBh 


SEND MESSAGE 

Purpose: Append data to the specified queue. 

Available on: All machines. Restrictions: Cswitch must be installed. 

Registers at call: Return Registers: 

AH = OBh AX = FFFEh triggered by something arriving, redo the 
CX = number of bytes to write call 

DS:SI -> buffer = FFFFh bad queue number 

DX = queue number (0-63) = 0000h no message was on queue 


else number of bytes in message 
Conflicts: MS SQL Server/Sybase DBLIBRARY (chapter 27), PC Tools 7 COMMUTE (chapter 33). 
See Also: Functions 0Ah and 0Ch 


INTERRUPT 62h - Function 0Ch 
READ MESSAGE 


Purpose: Retrieve the next message in the specified queue, 
Available on: All machines. Restrictions: Cswitch must be installed, 
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Registers at call: Return Registers: 
AH = 0Ch AX = FFFFh bad queue number 
CX = number of bytes to read else number of bytes transferred 


DS:SI -> buffer 

DX = queue number (0-63) 

Conflicts: MS SQL Server/Sybase DBLIBRARY (chapter 27), PC Tools 7 COMMUTE (chapter 33). 
See Also: Functions 0Ah and OBh 


INTERRUPT 62h - Function 0Dh 
DON'T ALLOW TASK TO BE SWAPPED OUT 


Purpose: Specify that the calling task must remain in main memory. 


Available on: All machines. Restrictions: Cswitch must be installed, 
Registers at call: Return Registers: n/a 
AH =0Dh 


Conflicts: MS SQL Server/Sybase DBLIBRARY (chapter 27), PC Tools 7 COMMUTE (chapter 33). 
See Also: Function 0Eh 


INTERRUPT 62h - Function 0Eh 
ALLOW TASK TO BE SWAPPED OUT 


Purpose: Specify that the calling task need not remain in main memory, and may be swapped to disk if memory 
becomes scarce, 


Available on: All machines. Restrictions: Cswitch must be installed. 
Registers at call: Return Registers: n/a 
AH = 0Eh 


Conflicts: MS SQL Server/Sybase DBLIBRARY (chapter 27), PC Tools 7 COMMUTE (chapter 33). 
See Also: Function 0Dh 


INTERRUPT 62h - Function 0Fh 
LOAD AND RUN PROGRAM FROM DISK 


Purpose: Start a new program. 


Available on: All machines. Restrictions: Cswitch must be installed. 
Registers at call: Return Registers: 

AH = OFh AX = 0000h task loader queue is full 
ES:BX -> command line = 0001h no error 


CX = priority (1-10) 
DX = background flag 
nonzero allows loading to EMS 
Conflicts; MS SQL Server/Sybase DBLIBRARY (chapter 27), PC Tools 7 COMMUTE (chapter 33). 
See Also: Functions 07h, 10h, and 13h 


INTERRUPT 62h - Function 10h 
TERMINATE SPAWNED PROGRAM 


Purpose: End the execution of the calling program. 


Available on; All machines. Restrictions: Cswitch must be installed. 
Registers at call: Return Registers: n/a 
AH = 10h 


Conflicts: MS SQL Server/Sybase DBLIBRARY (chapter 27), PC Tools 7 COMMUTE (chapter 33). 
See Also: Functions 07h and OFh 


INTERRUPT 62h - Function 11h 
GET TCB INFORMATION 


Purpose: Determine information about the caller's task control block. 
Available on: All machines. Restrictions: Cswitch must be installed. 
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Registers at call: Return Registers: 
AH= 11h AX =TCB indentifier 
ES:BX -> a pointer which will be set to the TCB 

address 


Conflicts: MS SQL Server/Sybase DBLIBRARY (chapter 27), PC Tools 7 COMMUTE (chapter 33). 
See Also: Function 12h 


INTERRUPT 62h ~- Function 12h 


GET TCB ADDRESS 

Purpose: Determine the address of the caller's task control block. 

Available on: All machines. Restrictions: Cswitch must be installed. 
Registers at call: Return Registers: 

AH = 12h AX = teb indentifier 


ES:BX -> a pointer which will be 
set to the tcb table address 
Conflicts: MS SQL Server/Sybase DBLIBRARY (chapter 27), PC Tools 7 COMMUTE (chapter 33). 


See Also: Function 11h 


INTERRUPT 62h - Function 13h 
CHECK STATUS OF PREVIOUS LOAD_TASK 


Purpose: Determine whether a request to start a new task was successful. 





Available on: All machines. Restrictions: Cswitch must be installed. 

Registers at call: Return Registers: 

AH = 13h AX = FFFCh no Memory Control Blocks available 
= FFFDh no TCBs available 
= FFFEh insufficient memory 
= FFFFh cannot open file 


= 0000h load in progress (not done yet) 
else TCB indentifier 
Conflicts: MS SQL Server/Sybase DBLIBRARY (chapter 27), PC Tools 7 COMMUTE (chapter 33). 
See Also: Function OFh 


INTERRUPT 7Fh - Function 09h 


SET TASK PRIORITY 

Purpose: Specify the relative importance of the calling task, 

Available on: All machines. Restrictions: MultiLink Advanced must be running. 
Registers at call: Return Registers: n/a 

AH = 09h 


AL = priority (0-7) 

Details: The MultiLink installation check consists of ensuring that the interrupt vector is not pointing at segment 
0000h, then checking whether the byte at offset 0000h in the interrupt handler's segment is E9h. 

Conflicts: Alloy NTNX and MW386 (chapter 18). 


INTERRUPT F4h 
GIVE UP REST OF CURRENT CLOCK TICK AND ALL OF NEXT TICK 


Purpose: This call is the same as INT 21h Function BEh and INT FEh. 
Available on; All machines, Restrictions; DoubleDOS must be running. 


Conflicts: None known. 
See Also: INT 21h Function EEh, INT FEh 


INTERRUPTS F5h through F9h 


Unknown Functions 
Purpose: unknown. 
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Available on: All machines. Restrictions: DoubleDOS must be running. 
Registers at call: unknown. Return Registers: unknown. 

Conflicts: None known. 

INTERRUPT FAh 

TURN OFF TIMESHARING 

Purpose: Temporarilly disable time-slicing while the caller processes time-critical or nonreentrant code. 
Available on: Ali machines. Restrictions: DoubleDOS must be running. 
Registers at call: n/a Return Registers: n/a 


Details: This call is the same as INT 21h Function EAh. 
Conflicts: None known. 
See Also: INT 21h Function EAh, INT FBh 


INTERRUPT FBh 

TURN ON TIMESHARING 

Purpose: Resume time-slicing after the caller completes the processing of time-critical or nonreentrant code. 
Available on: All machines, Restrictions: DoubleDOS must be running. 
Registers at call: n/a Return Registers: n/a 


Details: This call is the same as INT 21h Function EBh. 
Conflicts: None known. 
See Also: INT 21h Function EBh, INT FAh 


INTERRUPT FCh 
GET CURRENT SCREEN BUFFER ADDRESS 


Purpose: Determine the address of the memory to use instead of the physical display memory. 

Available on: All machines. Restrictions: DoubleDOS must be running. 

Registers at call: n/a Return Registers: 

ES = segment of display buffer 

Details: The display buffer may be moved if multitasking is enabled. This call is the same as INT 21h Function ECh. 
Conflicts: None known. 

See Also: INT 21h Function ECh, INT FBh 


INTERRUPT FOh 


Unknown Function 


Purpose: unknown. 

Available on: All machines. Restrictions: DoubleDOS must be running. 
Registers at call: unknown. Return Registers: unknown. 

Conflicts: None known. 


INTERRUPT FEh 
GIVE UP TIME 


Purpose: Indicate to DoubleDOS that the program is idle and that the CPU time it would normally receive may be 
given to the other program. 
Available on: All machines. Restrictions: DoubleDOS miuist be installed. 
Registers at call: Return Registers: n/a 
AL = number of 55ms time 
slices to give away 
Details: This call is the same as INT 21h Function EEh. 
Conflicts: 80286+ return from protected mode (chapter 1) 
See Also: INT 21h Function EEh, INT F4h 








Chapter 1 8 


Alloy Multiuser/Network Systems 


One of the first mini-network solutions for small office use was the Alloy network system, which originally made it 
possible to add a "dumb terminal" to a PC as an additional, independently operating, console. From this beginning, 
the system has evolved into a true networking solution based on a host-slave relationship rather than peer-to-peer or 
server-oriented operation, The three Alloy Computer Products systems described here are the Alloy NetWare Support 


Kit (ANSK), Novell-Type Network Executive (NTNX), and 386/MultiWare (MW386). 


In this chapter, all interrupt functions that are unique to the Alloy systems are described, in sequence of interrupt 
number and function number within each interrupt. However, Alloy also shares a number of functions with Novell 
networks, which are described in Chapter 20, and it shares three functions with PC-Net, which are described in chap- 


ter 27. 


INTERRUPT 10h - Function 8Bh 
FORCE WORKSTATION SCREEN UPDATE 


Purpose: Indicate that the calling program’s display should be brought up-to-date immediately. 

Available on: All machines. Restrictions: Alloy MW386 must be installed. 
Registers at call: Return Registers: n/a 

AH = 8Bh 

Conflicts: None known. 

See Also: Functions 92h and 93h 


INTERRUPT 10h - Function 90h 
GET PHYSICAL WORKSTATION DISPLAY MODE 


Purpose: Determine the true video mode for the workstation on which the calling program is running. 
Available on: All machines. Restrictions: Alloy MW386 must be installed. 


Registers at call: Return Registers: 

AH = 90h AL = current video mode (see Function 00h in 
chapter 5) 

Conflicts: None known. 


See Also: Function 91h 


INTERRUPT 10h - Function 91h 
GET PHYSICAL WORKSTATION ADAPTER TYPE 


Purpose: Determine type of video card installed in the workstation on which the calling program is running, 


Available on: All machines. Restrictions: Alloy MW386 must be installed. 
Registers at call: Return Registers: 
AH = 91h AL = video adapter type 
00h monochrome 
Olh Hereules monochrome graphics 
02h CGA 
03h EGA 
04h VGA 
80h monochrome text terminal 
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81h Hercules graphics terminal 
82h color graphics terminal 
Details: Types less than 80h do not imply that the current user is on the host. 
Conflicts: None known. 
See Also: Function 90h 


INTERRUPT 10h - Function 92h 
INHIBIT WORKSTATION SCREEN UPDATES 


Purpose: Indicate that the calling program's physical display should not be updated until explicitly enabled. 


Available on: All machines. Restrictions: Alloy MW386 must be installed. 
Registers at call: Return Registers: n/a 
AH = 92h 


Details: The terminal will be updated even when screen updates are inhibited if TTY output is used. 
Conflicts: None known. 
See Also: Function 8Bh 


INTERRUPT 10h - Function 93h 
REDRAW SCREEN 


Purpose: Indicate that the calling program's physical display should be completely repainted, in case the screen has 
been corrupted (as might be the case after data operations on the console port). 


Available on: All machines. Restrictions: Alloy MW386 must be installed. 
Registers at call: Return Registers: n/a 
AH = 93h 


Conflicts: None known. 
See Also: Function 8Bh 


INTERRUPT 14h - Function 20h 
ATTACH LOGICAL COMMUNICATIONS PORT TO PHYSICAL PORT 


Purpose: Map a logical port to a physical communications port address. 








Available on: All machines, Restrictions: Alloy MW386 must be installed. 
Registers at call: Return Registers: 
AH = 20h AX 5 status: 
AL = logical port 0000h successful 
(01h COMI, 02h COM2) FFFFh failed 


DX = physical port number 
Conflicts: X00 FOSSIL (chapter 7), MultiDOS Plus (chapter 16), 
See Also: Functions 21h, 22h, and 23h, INT 17h Function 8Bh 


INTERRUPT 14h - Function 21h 
RELEASE PHYSICAL COMMUNICATIONS PORT 


Purpose: Make the specified physical port available for other users of network. 


Available on: All machines. Restrictions: Alloy MW386 version 1.x must be 
installed, 
Registers at call: Return Registers: 
AH = 21h AX = status: 
DX = physical port number 0000h successful 
FFFFh failed 


Conflicts: X00 FOSSIL (chapter 7), MultiDOS Plus (chapter 16). 
See Also: Functions 20h and 22h 


INTERRUPT 14h - Function 22h 
RELEASE LOGICAL COMMUNICATIONS PORT 


Purpose: Detach the specified logical port from the physical port it was previously associated with. 
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Available on: All machines. Restrictions: Alloy MW386 version 2.0 or higher 
must be installed. 

Registers at call: Return Registers: 

AH = 22h AX = status (0000h successful) 


AL = logical port 

(01h COMI, 02h COM2) 
Conflicts: MultiDOS Plus (chapter 16). 
See Also: Functions 20h and 21h 


INTERRUPT 14h - Function 23h 
GET PORT NUMBER FROM LOGICAL PORT ID 


Purpose: Determine physical port number and mode of the specified logical COMx port. 


Available on: All machines. Restrictions: Alloy MW386 version 2.0 or higher 
must be installed. 

Registers at call: Return Registers: 

AH = 23h AL = MW386 port mode: 

AL = logical port (0Ih COMI, 02h COM2) bit 0: port is shared (spooler only) 

DH = user ID 1; port is spooled instead of direct (spooler only) 

DL & process ID (DH, DL both FFh for current 2: port is assigned as logical COM device, not in 
task) spooler 


3: port is free 
CX = MW386 port number 
DH = owner's user ID 
DL = owner's task ID 
Conflicts: MultiDOS Plus (chapter 16). 
See Also: Function 20h, INT 17h Function 8Bh 


INTERRUPT 14h - Function 24h 
CHANGE PHYSICAL PORT PARAMETERS 


Purpose: Establish operating conditions for the specified serial port. 


Available on: All machines. Restrictions: Alloy MW386 version 2.0 or higher 
must be installed. 

Registers at call: Return Registers: 

AH = 24h AH = 00h 


CX = physical 1/0 port number 
DS:DX -> configuration table 
(Table 18-1) 
Details: Invalid port numbers are merely ignored. 
Conflicts: MultiDOS Plus (chapter 16). 
See Also: INT 17h Function 96h 


Table 18-1. Format of Configuration Table: 


Offset Size Description 

00h BYTE baud rate: 
00h 38400 
Olh 19200 
02h 9600 
03h 7200 
04h 4800 
05h 3600 
06h 2400 
07h 2000 
08h 1200 
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Table 18-1. Format of Configuration Table (continued) 


Offset Size Description 
09h 600 
OAh 300 
OBh 150 
OCh 134.5 

Oth BYTE data bits: 
00h=5 
O1h=6 
O2h=7 
03h=8 

021 BYTE parity: 

00h none 

Olh odd 

02h even 

03h BYTE stop bits: 

OOh=1 

Olh=2 

04h BYTE receive flow control: 

00h none 

Olh XON/XOFF 

02h DTR/DSR. 

03h XPC 

04h RTS/CTS 

05! BYTE transmit flow control (as for receive) 


INTERRUPT 17h - Function 81h 
CANCEL JOBS FOR CURRENT USER 


Purpose: Cancel the specified number of print jobs most recently submitted by the caller. 











Available on: All machines. Restrictions: Alloy NTNX or MW386 must be 
installed. 

Registers at call: Return Registers: 

AH = 81h AL = status 

AL = 00h (NTNX compatibility mode) 00h success 

CL = number of jobs to cancel OLh..7Fh warning 


80h general failure 
81h host overloaded (NTNX only) 
82h module busy (NTNX only) 
83h host busy (NTNX only) 
84h re-entry flag set 
85h invalid request 
86h invalid printer 
87h invalid process ID 
89h access denied 
8Ah option not available for given port type 
8Bh option not available for given task type 
91h printer busy 
C2h file not found 
C3h path not found 
C4h file access failure 
Details: This fucntion cancels the last CL printouts for the current task. 
Conflicts: None known. 
See Also: Function 82h 


INTERRUPT 17h - Function 82h 
CANCEL ALL JOBS FOR CURRENT USER 
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Purpose: Cancel all outstanding print jobs for the calling task. 


Available on: All machines. 


Registers at call: 

AH = 82h 

AL = 00h (NTNX compatibility mode) 
Conflicts: None known. 

See Also: Function 81h 


INTERRUPT 17h - Function 83h 
SET NUMBER OF COPIES 


Purpose: Establish the number of copies to be printed. 


Available on: All machines. 


Registers at call: 
AH = 83h 
AL = mode 
00h NTNX compatibility 
CL = number of copies (max 99, default 1) 
02h MW386 v2.0-+ 
BX = logical device 
number 
00h-03h = LPT1-LPT4 
04h-07h = COMI- COM4 
CX = number of copies 


Restrictions: Alloy NTNX or MW386 must be 
installed. 

Return Registers: 

AL = status (see Function 81h) 


Restrictions: Alloy NTNX or MW386 must be 
installed. 

Return Registers: 

AL = status (see Function 81h) 


Details: In NTNX compatibility mode, this function only affects LPT L. 


Conflicts: None known, 


INTERRUPT 17h - Function 84h 
GENERATE PRINT BREAK 


Purpose: Release spooled data for printing. 
Available on: All machines. 


Registers at call: 
AH = 84h 
AL = mode 
00h NTNX compatibility 
02h MW386 v2.0-+ 
BX = logical device number 
00h-03h = LPT 1-LPT4 
04h-07h = COM1-COM4 


Restrictions; Alloy NTNX or MW386 must be 
installed, 
Return Registers: n/a 


Details: This call closes the spool file and tells the spooler to queue the print job (LPT1 only under MW386 in 


NTNX compatibility mode). 
Conflicts: None known. 


INTERRUPT 17h - Function 87h 
SET INDOS POINTER 


Purpose: Permit a transient program to provide a pointer for flushing print buffers on user-written printer drivers. 


Available on: All machines. 


Restrictions: Alloy NENX must be installed. 
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Registers at call: Return Registers: 
AH = 87h BX,CX destroyed 
AL = 00h 


CX:BX -> buffer for user-written printer drivers 

Details: This function must be executed before the printer is enabled. 
Conflicts: None known. 

See Also: Function 8Ah 


INTERRUPT 17h - Function 88h 
REMOVE PRINTER FROM SPOOLER 


Purpose: Make the specified printer unavailable to the spooler by removing it from the spooler’s list of available 
printers. 


Available on: All machines. Restrictions: Alloy NTNX or MW386 must be 
installed, 

Registers at call: Return Registers: 

AH = 88h AH = status (see Function 81h) 

AL = mode 


00h NTNX compatibility 
DX = NTNX printer number 
00h host LPT1 
Olh host LPT2 
02h host LPT3 
03h host LPT4 
04h host COMI 
05h host COM2 
06h user's logical COM2 
07h user's terminal AUX port 
08h user's logical COMI (MW386 only) 
Oth MW386 
DX = MW386 printer number 
Conflicts: None known. 
See Also: Functions 89h and 8Bh 


INTERRUPT 17h - Function 89h 


ADD PRINTER TO SPOOLER 
Purpose: Make the specified printer available to the spooler by adding it to the spooler’s list of available printers. : 
Available on: All machines. Restrictions: Alloy NTNX or MW386 must be 
installed. 

Registers at call: Return Registers: 
AH = 89h AL = status (see Function 81h) 
AL = mode 

00h NTNX compatibility 

DX = NTNX printer number (see Function 
88h) 
Olh MW386 


DX = MW386 printer number 
Conflicts: None known. 
See Also: Functions 88h and 8Bh 


INTERRUPT 17h - Function 8Ah 
ACTIVATE USER-WRITTEN PRINTER DRIVER 


Purpose: Make a user-written printer driver active. 
Available on: All machines, Restrictions: Alloy NTNX must be installed. 





Registers at call: 

AH =8Ah 

others, if any, unknown, 
Conflicts: None known. 
See Also: Function 92h 


INTERRUPT 17h - Function 8Bh 
GET PHYSICAL DEVICE NUMBER FROM NAME 
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Return Registers: unknown. 


Purpose: Determine the physical device number corresponding to the given name string. 


Available on: All machines. 
Registers at call: 

AH = 8Bh 

DS:DX -> ASCIZ printer name 


Conflicts: None known. 
See Also: Functions 89h and 8Ch, INT 14h Function 20h 


INTERRUPT 17h - Function 8Ch 
GET DEVICE NAME FROM PHYSICAL DEVICE NUMBER 


Restrictions: Alloy MW386 must be installed. 
Return Registers: 
AL status (see also Function 81h) 


00h successful 
DX = physical device number 


Purpose: Determine the name string corresponding to the given device number. 


Available on: All machines. 

Registers at call: 

AH = 8Ch 

DX = physical device number 

ES:DI -> 17-byte buffer for ASCIZ device name 
Conflicts: None known. 

See Also: Functions 88h and 8Bh 


INTERRUPT 17h - Function 8Dh 
RESET SPOOLER 


Restrictions: Alloy MW386 must be installed. 


Return Registers: 
AL = status (see also Function 81h) 
00h successful 
ES:DI buffer filled 


Purpose: Initialize the spooler software to boot-up values and clear all buffers. 


Available on: All machines. 


Registers at call: 
AH = 8Dh 
AL = 00h 


Restrictions: Alloy NTNX or MW386 must be 


installed. 
Return Registers: 
AL = status (see Function 81h) 


Details: MW386 accepts this call for NTNX compatibility, but does nothing. 


Conflicts: None known, 


INTERRUPT 17h - Function 8Eh 

GET INT 28h ENTRY POINT 

Purpose: Determine the current INT 28h entry point. 
Available on: All machines. 

Registers at call: 

AH = 8Eh 

AL = 00h 

Conflicts: None known. 

See Also: Function 8Fh 


INTERRUPT 17h - Function 8Fh 
GET DOS INTERCEPT ENTRY POINT 


Purpose: Determine the current DOS intercept routine. 
Available on: All machines. 


Restrictions: Alloy NTNX must be installed. 
Return Registers: 
CX:BX -> INT 28h entry point 


Restrictions: Alloy NTNX must be installed. 
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Registers at call: 

AH = 8Fh 

AL=00h 

Conflicts; None known. 
See Also: Function 8Eh 


INTERRUPT 17h - Function 90h 
SPOOL FILE BY NAME 


Purpose: Specify a file to be queued for printing. 
Available on: All machines, 


Registers at call: 
AH = 90h 
AL = mode 
00h NTNX compatibility 
DL = printer code (FFh=current) (NTNX, 
MW386 v1.x only) 
DH = number of copies (FFh=current) 
(NTNX, MW386 v1.x only) 
02h MW386 v2.0+ 
BX = logical device number 
00h-03h = LPT1-LPT4 
04h-07h = COMI- COM4 
CX:SI -> ASCIZ pathname 


Details: In mode OOh, the file is always sent to logical LPT1. 


Conflicts: None known. 
See Also: Function AOh 


INTERRUPT 17h - Function 91h 
GET USER NUMBER AND CURRENT PRINTER 


Return Registers: 
CX:BX -> DOS intercept routine 


Restrictions: Alloy NTNX or MW386 must be 
installed. 

Return Registers: 

AL = status (see Function 81h) 


Purpose: Determine the caller's user number and current printer assignment for LPT 1 (or other device if MW386). 


Available on: All machines. 


Registers at call: 

AH = 91h 

AL = mode 
00h NTNX compatibility 
Olh MW386 


02h MW386 v2.0-+ 
BX = logical device number 
00h-03h = LPT1- LPT4 
04h-07h = COMI- COM4 
Conflicts: None known. 
See Also: Function 8Ch 


INTERRUPT 17h - Function 92h, Subfunction 00h 
CHECK PRINTER DRIVER 


Purpose: Determine whether a printer driver is installed. 
Available on: All machines. 


Restrictions: Alloy NINX or MW386 must be 
installed. 

Return Registers: 

AL = status (see Function 81h) 

CX = user number (00h = host) 

DX = currently selected printer number (00h-08h) 

CX = user number 

DX = physical device number of currently selected 
printer 

CX = user number 

DX = physical device number 


Restrictions: Alloy NTNX must be installed. 
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Registers at call: Return Registers: 
AH = 92h CL = driver state 

AL =00h Oth initialized 
CL = 00h 80h not initialized 


AX = status (see Function 81h) 
Conflicts: None known. 


See Also: Function 8Ah 
INTERRUPT 17h - Function 94h 
SELECT PRINTER 
Purpose: Specify which physical device will be associated with LPT! (or other logical device for MW386). 
Available on: All machines. Restrictions: Alloy NINX or MW386 must be 
installed. 
Registers at call: Return Registers: 
AH = 94h AL = status (see Function 8 fh) 
AL = mode 
00h NTNX compatibility 
DX = NTNX printer number (see Function 
88h) 
Olh MW386 
DX = MW386 printer number 
02h MW386 v2.0+ 
BX = logical printer number 
DX = MW386 printer number 
Details: Modes 00h and 01h affect only logical LPT1. 
Conflicts: None known. 
See Also: Functions 8Bh and 95h 
INTERRUPT 17h - Function 95h 
GET CURRENT PRINTER 
Purpose: Determine the physical device assigned to LPT! (or other logical device for MW386). 
Available on: all machines. Restrictions: Alloy NTNX or MW386 must be 
installed. 
Registers at call: Return Registers: 
AH = 95h AL = status (see Function 81h) 
AL = mode DX = NTNX printer number (see Function 88h) 
00h NTNX compatibility (FFFFh if current printer is not compatible with 
NTNX) 
Olh MW386 DX = MW386 printer number 
02h MW386 v2.0+ DX = MW386 printer number (FFFFh = none) 


BX = logical device number 
00h-03h = LPT1-LPT4 
04h-07h = COMI- COM4 
Details: Modes 00h and O1h return the printer number of logical LPT only. 
Conflicts: None known. 
See Also: Function 94h 


INTERRUPT 17h - Function 96h 
SET SERIAL PORT PARAMETERS 


Purpose: The documentation states that this is a NOP, doing only XOR AX,AX before returning, 
Available on: All machines. Restrictions: Alloy NTNX must be installed. 
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Registers at call: Return Registers: n/a 
AH = 96h 

AL =00h 

Conflicts: None known, 

See Also: INT 14h Function 24h 


INTERRUPT 17h - Function 97h 
SET DATA DRIVEN PRINT BREAK 


Purpose: Specify the embedded character sequence which will be used to indicate that the current job is ready for 
printing. 


Available on: All machines. Restrictions: Alloy NTNX or MW386 must be 
installed. 
Registers at call: Return Registers: 
AH = 97h AL = status (see Function 81h) 
AL =mode 
00h NTNX compatibility 
02h MW386 v2.0+ 


BX = logical device number 
00h-03h = LPT1-LPT4 
04h-07h = COM1- COM4 
CH,CL,DH = three character break 
sequence 
DL = subfunction 
00h set break string 
else reset break 
Details: Mode 00h affects only logical LPT1. When the break string is encountered, the spool file will be closed and 
queued for printing automatically. The break string is not permanently saved, and will be reset each time MW386 or 
the user is rebooted. 
Conflicts: None known. 


See Also: Function 9Bh 
INTERRUPT 17h - Function 98h 
RESTART PRINTER : 
Purpose: Continue printing after a printer error. l 
Available on: All machines. Restrictions: Alloy NTNX or MW386 must be i 

installed. / 
Registers at call: Return Registers: i 
AH = 98h AL = status ; 
AL = 00h 00h successful 
DL = printer number (FFh = current) O1h incorrect printer 

02h task not found 


Details: This call is a null function in MW386 because MW386 automatically continues after printer errors; it is 
included solely for NTNX compatibility. 
Conflicts: None known. 


INTERRUPT 17h - Function 99h 


GET/SET PRINTER MODE 

Purpose: Specify or determine the ownership and mode of a printer. 

Available on: All machines. Restrictions: Alloy NTNX or MW386 must be 
installed. 

Registers at call: Return Registers: 

AH = 99h AL = status (see Function 81h) 


AL = mode DH = mode (bits 1 and 2 set as left) 
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00h NTNX compatibility DL = printer owner's user number if not spooled 
DL = NTNX printer number (see Function 
88h) (FFh = task's current logical LPT1) 
DH = mode 
bit 0: get mode if 1, set mode if 0 
1: private (“attached”) 
2: direct instead of spooled 
3-7 reserved (0) 
Olh MW386 
DX = MW386 printer number 
CL = mode (as for DH above) 
Conflicts: None known. 


INTERRUPT 17h - Function 9Ah 


SET TAB EXPANSION 
Purpose: Control printer expansion of tab characters, 
Available on: All machines. Restrictions: Alloy NTNX or MW386 must be 
installed. 
Registers at call: Return Registers: 
AH = 9Ah AL = status (see Function 81h) 
AL = mode 
00h NTNX compatibility 


DX = NTNX printer number (see Function 
88h) (FFFFh = current logical LPT1) 
Olh MW386 
DX = MW386 printer number 
CL = tab length (00h = no expansion, O1h- 
63h = spaces per tab) 
Details: Beginning with MW386 v2.0, tab expansion is set on a per-printer basis rather than a per-user basis; NTNX 
and MW386 v1.x ignore DX. 
Conflicts: None known. 
See Also: Function A4h 


INTERRUPT 17h - Function 9Bh 
SET PRINT BREAK TIMEOUT 


Purpose: Specify the interval of idleness after which the current print job will automatically be closed and queued 
for printing. 


Available on: All machines. Restrictions: Alloy NTNX or MW386 must be 
installed. 
Registers at call: Return Registers: 
AH = 9Bh AL = status (see Function 81h) 
AL = mode 
00h NTNX compatibility 


CX = timeout value in clock ticks (1/18 sec) 
(00h = never) 
Olh MW386 
CX = timeout value in seconds (00h = 
never) 
02h MW386 v2.0+ 
BX = logical device number 
00h-03h = LPT1-LPT4 
04h-07h = COMI- COM4 
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CX = timeout value in seconds (00h = 
never) 
Details: Modes 00h and Oth affect only the current logical LPT1. 
Conflicts: None known. 
See Also: Function 97h 


INTERRUPT 17h - Function AOh 
SPOOL COPY OF FILE 


Purpose: Make a copy of the specified file in the spooler's directory and queue the copy for printing, allowing the 
original file to be modified or deleted while the copy is printed. 


Available on: All machines. Restrictions: Alloy MW386 must be installed. 
Registers at call: Return Registers: 
AH=A0Oh AL = status (see Function 81h) 
AL = mode 
00h NTNX compatibility 


DX = unknown (NTNX, MW386 v1.x only) 
CX:SI -> ASCIZ pathname 
02h MW386 v2.0+ 
BX = logical device number 
00h-03h = LPT1-LPT4 
04h-07h = COMI- COM4 
CX:S] -> ASCIZ pathname 
Details: In mode 00h, the file is printed on logical LPT 1. 
Conflicts: None known. 
See Also: Function 90h 


INTERRUPT 17h - Function Adh 
ENABLE/DISABLE FORM FEED 


Purpose: Control the spooler's use of formfeeds after print jobs. 


Available on: All machines. Restrictions: Alloy MW386 must be installed. 
Registers at call: Return Registers: 
AH = A4h AL = status (see Function 81h) 


AL = new state 
00h form feed after end of print job disabled 
Olh form feed enabled 
Details: This function only affects the current logical LPT 1. 
Conflicts: None known. 
See Also: Functions 9Ah and A6h, NTNX Host INT 7Fh Eunction 05h 


INTERRUPT 17h - Function A6h 
ENABLE/DISABLE BANNER PAGE 


Purpose: Control the generation of a banner page by the spooler. 


Available on: All machines. Restrictions: Alloy MW386 must be installed, 
Registers at call: Return Registers: 
AH = A6h AL = status (see Function 81h) 


AL = new state 
00h banner page before print job disabled 
O1h banner page enabled 
Details: This function only affects the current logical LPT1. 
Conflicts: None known. 
See Also: Function A4h 
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INTERRUPT 17h - Function A7h 


GET/SET SPOOL FLAGS 

Purpose: Control the spooler flags with a single command. 

Available on: All machines. Restrictions: Alloy MW386 version 2.0 or higher 
must be installed. 

Registers at call: Return Registers: 

AH=AT7h AL = status (see Function 81h) 


AL = spool flags 
bit 0: banner page enabled (see Function A4h) 
1: form feed enabled (see Function A6h) 
2-6; reserved (0) 
7; set flags if 1, get flags if 0 
BX = logical device number 
00h-03h = LPT1-LPT4 
04h-07h = COM1-COM4 
Details: The Alloy documentation does not state which register contains the result of a GET. 
Conflicts: None known. 
See Also: Functions A4h and A6h 


INTERRUPT 17h - Function A8h 
DEFINE TEMPORARY FILENAME 


Purpose: Specify the filename printed on the banner page for spool files collected from the application's printer 


output. 
Available on: All machines. Restrictions: Alloy MW386 must be installed. 
Registers at call: Return Registers: 
AH = A8h AL = status (see Function 81h) 
CX;:SI -> ASCIZ filename without extension (max 8 
chars) 


Conflicts: None known. 
See Also: Function A9h 


INTERRUPT 17h - Function A9h 
CHANGE TEMPORARY SPOOL DRIVE 


Purpose: Specify the drive on which the spooler stores temporary files. 


Available on: All machines. Restrictions: Alloy MW386 must be installed. 
Registers at call: Return Registers: 
AH = A9h AL = status (see Function 81h) 


AL = new spool drive (2=C:,3=D:,etc) 

Details: This function does not remove the previous spooling directory since jobs may be pending. 
Conflicts: None known. 

See Also: Function A8h 


INTERRUPT 17h - Function AAh 
GET REAL-TIME PRINTER STATUS 


Purpose: Determine the actual current status of the specified printer. 


Available on: Ali machines. Restrictions: Alloy MW386 version 2.0 or higher 
must be installed, 

Registers at call: Return Registers: 

AH = AAh AH = instantaneous printer status 

AL = mode 00h printer ready 


00h NTNX O1h not ready 
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DX = NTNX printer number (see Function 12h off line 
88h) 13h out of paper 
Olh MW386 14h general device failure 
DX = MW386 printer number 15h device timeout 


16h bad device number 
Conflicts: None known. 


INTERRUPT 17h - Function AFh 


CHECK SPOOLER 

Purpose: Determine whether the spooler is loaded and available for use. 

Available on: All machines. Restrictions: Alloy MW386 must be installed. 
Registers at call: Return Registers: 

AH= AFh AX = 55AAh if spooler is available 
Conflicts: None known. 

INTERRUPT 5Bh 

Used by Alloy NTNX 

Purpose: unknown, 

Available on: All machines. Restrictions: Alloy NTNX must be installed. 
Registers at call: unknown. Return Registers: unknown. 


Conflicts: Microsoft Network Transport Layer (chapter 27), AT&T Starlan Extended NetBIOS (chapter 27), Cluster 
adapter (chapter 27). 


INTERRUPT 7Fh 
INSTALLATION CHECK 


Purpose: Determine whether Alloy NTNX (Novell-Type Network Executive) or 386/MultiWare multitasking 
system is installed. 
Available on: All machines. Restrictions: none. 
Details: The words at C800h:0000h and C800h:0002h will both be 584Eh if this multitasking system is present. 
NTNX allows its API to be placed on a different interrupt than 7Fh at load time, 

To determine the actual vector used, open the device "SPOOLER" with INT 21h Function 3Dh Subfunction 02h, 
place it in RAW mode with INT 21h Function 44h Subfunctions 00h and 01h, then read one byte which will be the 
actual interrupt number being used; the other interrupts may be found with INT 7Fh Function 09h Subfunction 03h, 


INTERRUPT 7Fh 

INSTALLATION CHECK 

Purpose: Determine whether running under the ANSK (Alloy NetWare Support Kit) system, version 2.2 or higher. 
Available on: All machines, Restrictions: This check will not work on Slaves with 


less than IMB of RAM, or those using 
the SLIM.SYS device driver, 
Details: A program may determine that it is running on an ANSK Slave by checking the five bytes at FO00h:0000h 
for the ASCIZ signature "ANSK"; this address is RAM, and should not be written. 


INTERRUPT 7Fh - Function 00h 


SEMAPHORE LOCK AND WAIT 

Purpose: Attempt to gain exclusive access to a resource, waiting until the resource is available. 

Available on: All machines. Restrictions: Alloy NINX or MW386 must be 
installed. 

Registers at call; Return Registers: 

AH = 00h AL = status 

DS:DX -> ASCIZ semaphore name (max 64 bytes) 00h successful 


O1h invalid function 
02h semaphore already locked 
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03h unable to lock semaphore 

04h semaphore space exhausted 

05h host/target PC did not respond (NTNX) 
AH = semaphore owner if status=02h 


Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 
See Also: Functions 01h, 02h, and 41h, PC-Net INT 67h Function 00h (chapter 27) 


INTERRUPT 7Fh - Function 01h 


SEMAPHORE LOCK 

Purpose: Attempt to gain exclusive access to a resource, but return immediately if the resource is not available. 

Available on: All machines. Restrictions: Alloy NTNX or MW386 must be 
installed. 

Registers at call: Return Registers: 

AH =0Ih AL = status (see Function 00h) 

DS:DX -> ASCIZ semaphore name (max 64 bytes) AH = semaphore owner if status=02h 

Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 

See Also: Functions 00h, 02h, and 41h 

INTERRUPT 7Fh - Function 02h 

RELEASE SEMAPHORE 

Purpose: Indicate that the specified resource is now available for other tasks to use. 

Available on: All machines. Restrictions: Alloy NTNX or MW386 must be 
installed. 

Registers at call: Return Registers: 

AH = 02h AL = status 

DS:DX -> ASCIZ semaphore name (max 64 bytes) 00h successful 


Oth invalid function 
02h semaphore locked by other user 
AH = semaphore owner 
03h unable to unlock semaphore 
05h target PC did not respond 
Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 
See Also: Functions 00h, 01h, and 42h 


INTERRUPT 7Fh - Function 03h 


GET USER NUMBER 

Purpose: Determine the caller's user number, and (for MW386) on which machine the caller is running. 

Available on: All machines. Restrictions: Alloy ANSK, NTNX, or MW386 must 
be installed. 

Registers at call: Return Registers: 

AH = 03h AL = user number 


AH = machine number (MW386) 
Details: This function call is the recommended method for a CPU-bound process to prevent its priority from being 


lowered, 
Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 
See Also: Functions 04h, 05h, and Alh 


INTERRUPT 7Fh - Function 04h 


GET NUMBER OF USERS 
Purpose: Determine the total number of users on the current machine, 
Available on: All machines. Restrictions; Alloy NTNX or MW386 must be 


installed. 
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Registers at call: Return Registers: 
AH = 04h AL = total number of users on currrent machine 
(MW386) 


AL = number of slaves on system (NTNX) 
Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27), HLLAPI (IBM 3270 High-Level Language 
API), 
See Also: Function 03h 


INTERRUPT 7Fh - Function 05h 
LOCK/UNLOCK SYSTEM, SPOOLER CONTROL 


Purpose: Control user activity, the print spooler, and slave timers. 


Available on: All machines. Restrictions: Must be running on an Alloy NINX 
host. 

Registers at call: Return Registers: n/a 

AH = 05h 


AL = function 
00h lock system (disable slave services) 
O1h unlock system 
02h enable spooler 
03h disable spooler 
04h enable slave timer update 
05h disable slave timer update 
06h enable form feeds 
07h disable form feeds 
Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27), HDILOAD.EXE - 8514/A Video Controller 
Interface (chapter ). 
See Also: INT 17h Function A4h 


INTERRUPT 7Fh - Function 05h 


GET USER PARAMETERS 

Purpose: Retrieve operating environment and parameters for the calling task. , 

Available on: Ali machines. Restrictions: Must be running under Alloy MW386 or 
on an Alloy NTNX slave, 

Registers at call: Return Registers: 

AH = 05h buffer filled 


DX:DI -> buffer for user information record 

(Table 18-2) 
Details: MW386 provides this function for backward compatibility only, and sets many of the fields to zero because 
they are meaningless under MW386. This function has no effect when called by the host (user 0). 
Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27), HDILOAD.EXE - 8514/A Video Controller 
Interface (chapter ). 
See Also: Function 03h 


Table 18-2. Format of user information record: 


Offset Size Description 
00h WORD segment of video RAM 
02h WORD segment of secondary copy of video RAM 
04h WORD offset of screen update flag (see INT 10h Function 8Bh) flag nonzero if update needed 
06h WORD video NMI enable port (not used by MW386, set to 0000h) 
O8h WORD video NMI disable port (not used by MW386, set to 0000h) 
OAh BYTE processor type 
00h 8088 


Oth V20 


1 
i 
{ 
i 
i 
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Table 18-2, Format of User Information Record (continued) 





Offset Size Description 
02h 8086 
03h V30 
06h 80386 
OBh WORD multitasking flag (00h = single tasking, 01h = multitasking) (not used by MW386, set to 
0000h) 
ODh WORD offset of terminal driver (not used by MW386, set to 0000h) 
OFh BYTE port for console I/O (not used by MW386, set to 0000h) 
10h WORD offset of processor communication busy flag; bit 7 set when slave communicating with 
host 
12h WORD pointer to FAR NX system call (not used by MW386, set to 0000h) 
14h WORD offset of 16-byte user configuration record (see Function 38h) 
16h WORD offset of command/status word 
18h WORD offset of screen valid flag (see INT 10h Function 93h) nonzero if screen must be repainted 
1Ah WORD offset of screen repaint flag 
1Ch WORD pointer to NEAR NX system call (not used by MW386, set to 0000h) 
1Eh WORD offset for intercept flags (not used by MW386, set to 0000h) intercept flag = FFh if 
MSDOS intercepts should be disabled 
20h WORD offset of terminal lock flag (see INT 10h Function 92h) lock flag = FFh if backgrnd screen 
updates should be suspended 
22h 26 BYTEs reserved 
INTERRUPT 7Fh - Function 06h 
GET SHARED DRIVE INFO 
Purpose: Determine information about the specified drive shared with the network, 
Available on: All machines. Restrictions: Must be running on an Alloy NTNX 
host. 
Registers at call: Return Registers: 
AH = 06h AX = status 
AL = drive number (1=A:, 2=B:, etc) 0000h successful 
ES:DI -> drive info record (Table 18-3) ES:DI buffer filled 


0001h not shared drive 
Conflicts: None known. 


Table 18-3. Format of Drive Info Record: 


Offset Size Description 

00h WORD segment of drive IO-REQUEST structure (MSDOS DPB) 

02h WORD segment of allocation map (owner table) one byte per FAT entry, containing user ID 
owning that entry 

04h WORD segment of master FAT for drive (copy of FAT on disk) 

06h WORD pointer to configuration file 

O8h WORD total number of clusters 

OAh WORD bytes per sector 

0Ch WORD sectors per cluster 

OEh BYTE FAT type (O0Ch = 12-bit, 10h = 16-bit) 


INTERRUPT 7Fh - Function 06h 
ALLOCATE FREE CLUSTER ON SHARED DRIVE 


Purpose: Dynamically reallocate space on the specified shared drive. 


Available on: All machines, Restrictions: Must be running on an Alloy NTNX 
slave. 
Registers at call: Return Registers: 


AH = 06h AH = status 
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DL = drive number (1=A:,2=B:,etc) 00h successful 
CX = number of clusters to allocate CX = number of clusters still free 
10h invalid shared drive request 
CL = first and second shared drives 
11h invalid cluster count 
(must be 01h-FFh) 
Conflicts: None known. 


INTERRUPT 7Fh - Function 07h 
GET LIST OF SHARED DRIVES 


Purpose: Determine which disks are shared with other machines on the network. 


Available on: All machines. Restrictions: Alloy NTNX or MW386 must be 
installed. 

Registers at call: Return Registers: 

AH =07h ES:DI -> shared drive list (Table 18-4) 


Details: MW386 considers all fixed disks to be shared drives; only C and D will be returned as shared. 
Conflicts: None known. 


Table 18-4. Format of shared drive list: 


Offset Size Description 
00h . BYTE string length 
Olh BYTE number of shared drives 
02h NBYTEs one byte per shared drive 
INTERRUPT 7Fh - Function 08h, Subfunctions 00h and 01h 
GET INTERRUPT VECTORS 
Purpose: Determine the entry point the specified interrupt used by the system software, 
Ayailable on: All machines. Restrictions: Must be running on an Alloy NTNX 
host. : 
Registers at call: Return Registers: i 
AH = 08h AL = status | 
CL = function 00h successful : 
00h get original interrupt vector Olh interrupt vector not used by network executive i 
Oh get Network Executive interrupt 
AL = interrupt number 02h invalid subfunction 


DX:SI -> DWORD to hold interrupt vector 

Details: The network executive uses interrupts 02h, 08h, 09h, OFh, 10h, 13h, 16h-19h, 1Ch, 20h, 28h, 2Ah, 2Fh, 
SBh, 67h, 7Fh, ECh, and FOh-FFh. 

Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 

See Also: Function 09h Subfunction 03h, DOS INT 21h Function 35h (chapter 8) 


INTERRUPT 7Fh - Function 08h, Subfunction 02h 
SET MESSAGE DISPLAY TIMEOUT 


Purpose: Specify how long messages will be displayed. 


Available on: All machines. Restrictions: Alloy NTNX must be installed, 
Registers at call: Return Registers: 

AH = 08h AL = status 

CL=02h 00h successful 

DX = timeout in seconds 02h invalid subfunction 


Conflicts: None known. 
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INTERRUPT 7Fh - Function 09h, Subfunctions 00h and 01h 
ENABLE/DISABLE MUD FILE CHECKING 


Purpose: Specify whether the RTNX.MUD file will be checked. 


Available on: All machines. Restrictions: Alloy NTNX must be installed. 
Registers at call: Return Registers: n/a 
AH = 09h 


CL = function 
00h enable checking of RTNX.MUD file 
O1h disable RTNX.MUD checking 
Conflicts: MultiLink Advanced (chapter 17). 


INTERRUPT 7Fh - Function 09h, Subfunction 02h 
SWITCH HOST TO DEDICATED MODE 


Purpose: Specify that the host cease to provide workstation services, and only poll for I/O requests from the slave 
processors. 


Available on: All machines. Restrictions: Alloy NTNX must be installed. 
Registers at call: Return Registers: n/a 

AH = 09h 

CL = 02h 


Conflicts: MultiLink Advanced (chapter 17), 


INTERRUPT 7Fh - Function 09h, Subfunction 03h 
GET ALTERNATE INTERRUPT 


Purpose: Determine the actual interrupt number used to provide a particular service, 


Available on: All machines. Restrictions: Alloy NTNX or MW386 must be 
installed. 

Registers at call: Return Registers: 

AH = 09h CL = actual interrupt which handles the specified 

CL = 03h interrupt's calls 


AL = default interrupt number (67h,7Fh, etc) 
Conflicts: MultiLink Advanced (chapter 17). 
See Also: Function 08h 


INTERRUPT 7Fh - Function 0Ah, Subfunction 00h 


GET SYSTEM FLAGS 

Purpose: Determine the addresses of important system flags. 

Available on: All machines. Restrictions: Alloy NTNX must be installed. 
Registers at call: Return Registers: 

AH = 0Ah ES:DI buffer filled 

CL =00h 


ES:DI -> buffer for system flags (Table 18-5) 
Details: On a slave, only the NX_Busy flag is returned. All three flags are at fixed positions, so this function only 
needs to be called once. An interrupt handler should only perform DOS or device accesses when all three flags are 


00h. 


Table 18-5. Format of System Flags: 


Offset Size Description 
00h DWORD _ pointer to NX_Busy flag (nonzero when communicating with users) 
04h DWORD _ pointer to device driver busy flag 


08h DWORD pointer to InTimer flag 
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INTERRUPT 7Fh - Function 0Bh, Subfunction 02h 
SET/RESET GRAPHICS DOS ON SLAVE 


Purpose: Specify whether or not graphics will be available on the indicated slave processor, 


Available on: All machines. Restrictions: Must be running on an Alloy NTNX 
host. 

Registers at call: Return Registers: 

AH = 0Bh AL = status 

CL = 02h 00h successful 

AL = slave ID number Oth nothing done, proper DOS type already loaded 


CH = DOS to activate 
00h graphics DOS 
Olh character DOS 

Conflicts: None known. 


INTERRUPT 7Fh - Function 10h, Subfunction 00h 
CHANNEL CONTROL - OPEN CHANNEL 


Purpose: Prepare a channel for reception. 


Available on: All machines. Restrictions; Alloy NTNX or MW386 must be 
installed. 

Registers at call: Return Registers: 

AH= 10h AL = status 

CL =00h 00h successful 

AL = channel number O1h busy 

DX:DI -> channel buffer 02h channel range error (not O0h-3Fh) 


03h invalid subfunction 
ODh unable to open 
Details: This function may not be invoked from within a hardware interrupt handler. 
Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 

See Also: Function 10h Subfunctions 01h and 04h, Function 14h Subfunction 02h 


INTERRUPT 7Fh - Function 10h, Subfunction 01h 
CHANNEL CONTROL - CLOSE CHANNEL 


Purpose: Disable reception on the specified channel and clear its buffer pointer. 





Available on: All machines. Restrictions: Alloy NTNX or MW386 must be 
installed. 

Registers at call; Return Registers: 

AH = 10h AL = status 

CL=01h 00h successful 

AL = channel number Olh busy 


02h channel range error (not O0h-3Fh) 
03h invalid subfunction 
OAh channel not open 

Details: This function may not be invoked from within a hardware interrupt handler. 

Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27), 

See Also: Function 10h Subfunctions 00h and 05h 


INTERRUPT 7Fh - Function 10h, Subfunction 02h 

CHANNEL CONTROL « LOCK CHANNEL 

Purpose: Temporarily stop reception on the specified channel. 

Available on: All machines. Restrictions: Alloy NTNX or MW386 must be 
installed. 
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Registers at call: Return Registers: 
AH = 10h AL = status 

CL =02h 00h successful 
AL = channel number Oh busy 


02h channel range error (not 0Oh-3Fh) 
03h invalid subfunction 
OAh channel not open 
OCh channel already locked 
Details: This function may not be invoked from within a hardware interrupt handler. 
Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 
See Also: Function 10h Subfunctions 03h, 06h, and 08h 


INTERRUPT 7Fh - Function 10h, Subfunction 03h 
CHANNEL CONTROL - UNLOCK CHANNEL 


Purpose: Resume reception on the specified channel. 


Available on: All machines. Restrictions: Alloy NTNX or MW386 must be 
installed. 

Registers at call: Return Registers: 

AH= 10h AL = status (see Function 10h Subfunction 02h) 

CL=03h 


AL = channel number 
Details: This function should only be used on channels locked with Function 10h Subfunction 02h, not on those 


locked by receipt of a datagram. It may not be invoked from within a hardware interrupt handler. 
Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 
See Also: Function 10h Subfunctions 02h, 04h, and 09h 


INTERRUPT 7Fh - Function 10h, Subfunction 04h 
CHANNEL CONTROL - RELEASE BUFFER 


Purpose: Indicate that the datagrame in the channel buffer has been processed. 


Available on: All machines. Restrictions; Alloy NTNX or MW386 must be 
installed. 

Registers at call: Return Registers: 

AH = 10h AL & status 

CL = 04h 00h successful 

AL = channel number Oth busy 


02h channel range error (not 00h-3Fh) 
03h invalid subfunction 
Details: This function unlocks buffer after received datagram has been processed. It may not be invoked from within 
a hardware interrupt handler. 
Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 
See Also: Function 10h Subfunction 00h 


INTERRUPT 7Fh - Function 10h, Subfunction 05h 
CHANNEL CONTROL - CLOSE ALL CHANNELS 


Purpose: Clear all pending datagrams and close every open channel. 


Available on: All machines. Restrictions: Alloy NTNX or MW386 must be 
: installed. 
Registers at call: Return Registers: 
AH = 10h AL = status 
CL = 05h 00h successful 
Olh busy 


02h channel range error (not 00h-3Fh) 
03h invalid subfunction 
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Details: This call clears al] pending datagrams and clears buffer pointers before closing the channels. It may not be 
invoked from within a hardware interrupt handler. 

Conflicts: Halo&88 API (chapter 5), ClusterShare access (chapter 27). 

See Also: Function 10h Subfunction 0ih 


INTERRUPT 7Fh - Function 10h, Subfunction 06h 
CHANNEL CONTROL - LOCK ALL OPEN CHANNELS 


Purpose: Temporarily stop reception on all open channels. 


Available on: All machines. Restrictions: Alloy NTNX or MW386 must be 
installed, 
Registers at call: Return Registers: 
AH = [0h AL = status 
CL = 06h 00h successful 
Olh busy 


02h channel range error (not 0Oh-3Fh) 
03h invalid subfunction 

Details: This functio may not be invoked from within a hardware interrupt handler. 

Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 

See Also: Function 10h Subfunctions 02h and 08h 


INTERRUPT 7Fh - Function 10h, Subfunction 07h 
CHANNEL CONTROL - UNLOCK ALL LOCKED IDLE CHANNELS 


Purpose: Restart reception on all open channels which have no datagrams. 


Available on: All machines. Restrictions; Alloy NTNX or MW386 must be 
installed. 
Registers at call: Return Registers: 
AH = 10h AL = status 
CL=07h 00h successful 
Olh busy 


02h channel range error (not 0O0h-3Fh) 
03h invalid subfunction 
Details: This call unlocks all locked channels which have no pending datagrams. It may not be invoked from within 
a hardware interrupt handler. 
Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 
See Also: Function 10h Subfunctions 03h and 09h 


INTERRUPT 7Fh - Function 10h, Subfunction 08h 
CHANNEL CONTROL - LOCK MULTIPLE CHANNELS 


Purpose: Temporarily stop reception on the specified set of channels. 


Available on: All machines. Restrictions; Alloy NTNX or MW386 must be 
installed, 

Registers at call: Return Registers: 

AH = 10h AL = status 

CL = 08h 00h successful 

DX = maximum channel number to lock Olh busy 


02h channel range error (not 0Oh-3Fh) 
03h invalid subfunction 
Details: This call locks channels numbered 00h through the value in DX. It may not be invoked from within a 
hardware interrupt handler. 
Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27), 
See Also: Function 10h Subfunctions 02h, 06h, and 09h 
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INTERRUPT 7Fh - Function 10h, Subfunction 09h 
CHANNEL CONTROL - UNLOCK MULTIPLE CHANNELS 


Purpose: Resume reception on the specified set of channels. 


Available on: All machines. Restrictions: Alloy NTNX or MW386 must be 
installed. 

Registers at call: Return Registers: 

AH = 10h AL = status 

CL =09h 00h successful 

DX = maximum channel number to unlock Olh busy 


02h channel range error (not 0Oh-3Fh) 
03h invalid subfunction 
Details: This functio unlocks channels numbered 00h through the value in DX. It may not be invoked from within a 
hardware interrupt handler. 
Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 
See Also: Function 10h Subfunctions 03h, 07h, and 08h 


INTERRUPT 7Fh - Function 11h 


SEND DATAGRAM 

Purpose: Transmit a datagram to the specified user(s). 

Available on: All machines, Restrictions: Alloy NTNX or MW386 must be 
installed, 

Registers at call: Return Registers: 

AH = 1th AL = status 

DX:SI -> request block (Table 18-6) 00h successful 


O1h busy 
02h channel range error (not 00h-3Fh) 
03h invalid subfunction 
OAh packet too large (or <2 bytes if NTNX) 
OBh can't send packet to itself 
OCh invalid number of destinations 
ODh destination channel number out of range 
OEh destination user is busy 
OFh destination user has locked channel 
10h channel not open 
11h no datagram server on destination (NTNX) 
Details: If the wildcard channel FFh used, the actual channel number will be filled in. 
Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 
See Also: Function 12h 


Table 18-6. Format of Request Block: 


Offset Size Description 

00h DWORD pointer to packet to send 

04h WORD packet size in bytes (1-4096) 

06h BYTE number of destinations for packet (max | Fh) 

07h 31 BYTEs destination user IDs (FFh = broadcast to all except sender) 
26h 31 BYTEs destination channels (FFh = first available channel) 

45h 31 BYTEs return destination statuses 

INTERRUPT 7Fh - Function 12h 

ACKNOWLEDGE DATAGRAM 


Purpose: Send an acknowledgement of the receipt of a datagram back to its sender. 
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Available on: All machines. Restrictions: Alloy NTINX or MW386 must be 
installed. 

Registers at call: Return Registers: 

AH = 12h AL = status 

AL = channel number being acknowledged 00h successful 

DI:DX = 32-bit status to return to sender Oth busy 


02h channel range error (not 00h-3Fh) 
03h invalid subfunction 
OAh channel not open 
OBh no message in channel 
OCh destination slave busy--retry (NTNX) 
ODh destination user not active 
OEh destination slave not active (NTNX) 
OFh destination disabled datagram service 
Details: This call also unlocks the channel, allowing the next datagram to be received. 
Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27), 
See Also: Function 11h, Function 15h Subfunction 04h 


INTERRUPT 7Fh - Function 13h, Subfunction 00h 
RESET USER DATAGRAMS 


Purpose: Clear all pending datagrams and remove all channels which are open in NTNX-compatible mode and 
belong to the current task, in preparation for the termination of the task. 


Available on: All machines. Restrictions: Alloy NTNX or MW386 must be 
installed. 

Registers at call: Return Registers: n/a 

AH = 13h 

CL=00h 


Conflicts: None known. 


INTERRUPT 7Fh - Function 14h, Subfunction 00h 


SET RECEIVE ISR 
Purpose: Specify a handler to be called upon the receipt of a datagram. 
Available on: All machines. Restrictions: Alloy NTNX or MW386 must be 
installed. 
Registers at call: Return Registers: 
AH = 14h AL = status 
CL = 00h 00h successful 
DX:DI -> application FAR receive service routine O1h busy 
(see below) 02h channel range error (not 00h-3Fh) 


03h invalid subfunction 
Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 
See Also: Function 14h Subfunctions 01h and 03h 


Service routine called with: 
DH = sender ID 
DL = channel with datagram 
interrupts disabled 


Return Registers: 
AL = response code 
00h leave buffer locked, set channel status, and repeat call later 
O1h release channel buffer 
02h change buffer pointer to DX:DI 
AH, CX, DX, DI, SI may be destroyed 


j 
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INTERRUPT 7Fh - Function 14h, Subfunction 01h 


SET ACKNOWLEDGE ISR 
Purpose: Specify a handler to be called upon the receipt of an acknowledgement. 
Available on: All machines. Restrictions: Alloy NTNX or MW386 must be 
installed. 
Registers at call: Return Registers: 
AH = 14h AL=5 status 
CL=01h 00h successful 
DX:DI -> application FAR acknowledge service Olh busy 
routine (see below) 02h channel range error (not 0O0h-3Fh) 


03h invalid subfunction 


Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27), 
See Also: Function 12h, Function 14h Subfunctions 00h and 04h, Function 15 Subfunction 04h 


Service routine called with: 
DS:SI -> acknowledge structure (see Function 15h Subfunction 04h) 


Return Registers: 
AL = response code 
0h application busy, network executive should call again later 
Olh acknowledge accepted 
AH, DX, SI may be destroyed 


INTERRUPT 7Fh - Function 14h, Subfunction 02h 
SET CHANNEL BUFFER POINTER 


Purpose: Specify the data buffer to be used by the indicated channel. 


Available on: All machines, Restrictions: Alloy NTNX or MW386 must be 
installed. 

Registers at call: Return Registers: 

AH = 14h AL = status 

CL = 02h 00h successful 

AL = channel number Oth busy 

DX:DI -> receive buffer 02h channel range error (not 0Oh-3Fh) 


03h invalid subfunction 
Details: This function may be called from within a receive ISR or when a datagram is pending. 
Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27), 
See Also: Function 10h Subfunction 00h, Function 14h Subfunction 00h 


INTERRUPT 7Fh - Function 14h, Subfunction 03h 


GET RECEIVE ISR 

Purpose: Determine which handler is called upon the receipt of a datagram. 

Available on: All machines. Restrictions: Alloy NTNX or MW386 must be 
installed. 

Registers at call: Return Registers: 

AH = 14h DX:DI -> current receive ISR 

CL = 03h 


Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 
See Also: Function 14h Subfunctions 00h and 04h 


INTERRUPT 7Fh - Function 14h, Subfunction 04h 
GET ACKNOWLEDGE ISR 


Purpose: Determine which handler is called upon the receipt of an acknowledgement. 
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Available on: All machines. Restrictions: Alloy NTNX or MW386 must be 
installed. 

Registers at call: Return Registers: 

AH= 14h DX:DI -> current acknowledge ISR 

CL = 04h 


Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 
See Also: Function 14h Subfunctions 01h and 03h 


INTERRUPT 7Fh - Function 14h, Subfunction 05h 


GET BUSY POINTER 

Purpose: Determine the address of a flag which indicates whether the system software is busy. 

Available on: All machines. Restrictions: Must be running under Alloy MW386 or 
on an Alloy NTNX host. 

Registers at call: Return Registers: 

AH = 14h DX:DI buffer filled 

CL=05h 

DX:DI -> buffer for busy structure (Table 18-7) 

Conflicts: None known. 

Table 18-7, Format of Busy Structure: 

Offset Size Description 

00h DWORD pointer to busy flag byte 

04h WORD fixed port address (FFOOh) 

INTERRUPT 7Fh - Function 15h, Subfunction 00h 

GET CHANNEL STATUS 

Purpose: Determine the status of the specified channel. 

Available on: All machines. Restrictions: Alloy NINX or MW386 must be 
installed. 

Registers at call: Return Registers: 

AH= 15h AL = status ' 

CL =00h 00h successful 

AL = channel number Oth busy 

DX:DI -> status structure (Table 18-8) 02h channel range error (not 00h-3Fh) 


03h invalid subfunction 
Conflicts; Halo88 API (chapter 5), ClusterShare access (chapter 27), 
See Also: Function 15h Subfunction 01h 


Table 18-8. Format of Status Structure: 


Offset Size Description 
00h BYTE channel status 
bit 0: channel open 
1: channel buffer contains received data 
7: channel locked 


Olh BYTE sender ID 

INTERRUPT 7Fh - Function 15h, Subfunction 01h 

GET NEXT FULL CHANNEL 

Purpose: Determine the next channel which requires servicing. 

Available on: All machines. Restrictions: Alloy NTNX or MW386 must be 


installed, 
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Registers at call: Return Registers: 
AH = 15h AL = status 
CL=01h 00h successful 
DX:DI -> full-channel structure (Table 18-9) Olh busy 


OAh no datagrams available 
Details: MW386 v1.0 returns the lowest channel with a datagram; newer versions and NTNX return the oldest 
datagram. 
Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 
See Also: Function 15h Subfunction 00h 


Table 18-9. Format of full-channel structure: 


Offset Size Description 
00h BYTE number of channel with oldest datagram 
Olh BYTE sender ID 


INTERRUPT 7Fh - Function 15h, Subfunction 02h 
GET MAXIMUM NUMBER OF CHANNELS 


Purpose: Determine the maximum number of channels available on the network. 


Available on: All machines. Restrictions: Alloy NTNX or MW386 must be 
installed. 

Registers at call: Return Registers: 

AH = 15h AH = number of channels available (40h for MW386) 

CL=02h 


Details: The application may always assume at least 32 channels available. 
Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 
See Also: Function 15h Subfunction 03h 


INTERRUPT 7Fh - Function 15h, Subfunction 03h 


GET MAXIMUM PACKET SIZE 

Purpose: Determine the maximum size of a packet permitted on the network. 

Available on: All machines. Restrictions: Alloy NTNX or MW386 must be 
installed. 

Registers at call: Return Registers: 

AH = [5h buffer WORD filled with maximum packet size (4096 

CL=03h for MW386) 

DX:DI -> WORD for return value 

Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 

See Also: Function 15h Subfunction 02h 

INTERRUPT 7Fh - Function 15h, Subfunction 04h 

GET AND CLEAR ACKNOWLEDGE STATUS 

Purpose: Determine whether a new acknowledgement has been received. 

Available on: All machines. Restrictions: Alloy NTNX or MW386 must be 
installed. 

Registers at call: Return Registers: 

AH = [Sh AL = status 

CL = 04h 00h successful 

DX:DI -> status structure (Table 18-10) DX:DI structure filled 

Oth busy 


0Ah no acknowledgement has arrived 
Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 
See Also: Function 12h, Function 14h Subfunction Oth 
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Table 18-10. Format of Status Structure: 


Offset Size Description 

00h BYTE sender ID 

Oth BYTE channel number 

02h 4BYTEs receiver status (see Function 12h) 

INTERRUPT 7Fh - Function 16h 

DIRECT MEMORY TRANSFER 

Purpose: Peform a direct memory-to-memory transfer between two users. 

Available on: All machines, Restrictions: Alloy NTNX or MW386 must be 
installed. 

Registers at call: Return Registers: 

AH = 16h AL = status 

DX:SI -> transfer structure (Table 18-11) 00h successful 


OAh source or destination out of range 

OBh transfer kernal busy--try again 
Details: This call transfers memory contents directly between users; both source and destination user IDs may differ 
from the caller's ID, No segment wrap is allowed. 


Table 18-11, Format of Transfer Structure: 


Offset Size Description 

00h WORD bytes to transfer 

02h BYTE source ID 
FEh = caller 

03h DWORD _ source address 

07h BYTE destination ID 
FFh = all slaves except caller 
FEh = caller 

08h DWORD _ destination address 


INTERRUPT 7Fh - Function 21h 
SEND MESSAGE OR COMMAND TO USER(S) 


Purpose: Transmit a message or command to the specified user or to all users. 


Available on: All machines. Restrictions: Alloy NTNX or MW386 must be 
installed. 

Registers at call: Return Registers: n/a 

AH = 21h 


AL = sender's user ID 

DS:DX -> control packet (Table 18-12) 

Details: Messages or commands are ignored if disabled by the destination user. 
Conflicts; Halo88 API (chapter 5), ClusterShare access (chapter 27). 

See Also: Function 22h 


Table 18-12. Format of Control Packet: 


Offset Size Description 
00h BYTE packet type: 00h message 
01h NTNX command 
02h MW386 command 
Oth BYTE destination user ID or 'A' for all users 
02h 62 BYTEs ASCIZ message (packet type 00h) BIOS keycodes terminated by NUL byte (type 01h) or 


word (02h) 
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A maximum of 16 keycodes will be processed for NTNX and MW386 commands. 
INTERRUPT 7Fh - Function 22h 


GET MESSAGE 

Purpose: Display pending messages on the user's screen. 

Available on: All machines. Restrictions: Alloy NTNX must be installed. 
Registers at call: Return Registers: 

AH = 22h pending messages displayed on user's screen 


Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 
See Also: Function 21h 


INTERRUPT 7Fh - Function 24h, Subfunctions 00h and 01h 
ATTACH OR RELEASE DRIVE FOR LOW-LEVEL WRITE ACCESS 


Purpose: Request control of a floppy drive for writing or a hard disk for low-level writes. 


Available on: All machines. Restrictions: Alloy NTNX or MW386 must be 
installed, 
Registers at call: Return Registers: 
AH = 24h AX = status 
CL = function 00h successful 
00h attach Oth invalid request 
Olh release 02h already attached 
CH = drive (0=A:,1=B:,etc) 03h not attached 


04h lock table full 
Details: Only drives on the current machine may be attached. 
Conflicts: None known. 


INTERRUPT 7Fh - Function 24h, Subfunctions 02h and 03h 
ATTACH/RELEASE HOST PROCESSOR 


Purpose: Temporarily take control of the host processor to perform I/O on the host system. 


Available on: All machines. Restrictions: Alloy NTNX must be installed. 
Registers at call: Return Registers: 
AH = 24h AX = status 
CL = function 00h successful 
02h attach host Oh invalid request 
03h release host 02h already attached 
03h not attached 
04h lock table full 


Conflicts: None known. 


INTERRUPT 7Fh - Function 25h, Subfunctions 00h and 01h 
GET NETWORK EXECUTIVE TYPE AND VERSION 


Purpose: Determine the type and version of the network executive. 


Available on: All machines. Restrictions: Alloy ANSK, NTNX, or MW386 must 
be installed. 
Registers at call: Return Registers: 
AH = 25h Function 00h: 
CL = function AH = version suffix letter 
00h get version CH = major version number 
Oth get type CL = minor version number 
Function O1h: 
CL = type 
00h RTINX 


Olh ATNX 
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02h NTNX 
03h BINX 
04h MW386 
05h ANSK 
Conflicts: None known. 
INTERRUPT 7Fh - Function 26h, Subfunction 00h 
GET NTNX FILE MODE 
Purpose: Determine the type of file access checking and disk buffer flushing to perform, 
Available on: All machines. Restrictions: Alloy NTNX or MW386 must be 
installed, 
Registers at call: Return Registers: 
AH = 26h AX = file mode bits 
CL=00h bit 0: directory protection enabled 


1: extended open enabled 

2: flush on every disk write 

3: flush on every disk write in locked interval 

4: flush on reads from simultaneously opened file 
Details: MW386 does not support file modes, and always returns AX=001Fh. 
Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 
See Also: Function 26h, Function 26h Subfunction 06h 


INTERRUPT 7Fh - Function 26h, Subfunctions 01h thru 05h 
SET FILE /O CHECKING LEVEL 


Purpose: Specify the types of file access checking and disk buffer flushing to perform. 


Available on: All machines. Restrictions: Alloy NTNX must be installed. 
Registers at call: Return Registers: n/a 
AH = 26h 


CL = check type to set/reset 

Oth directory protection 

02h extended open 

03h flush on every disk write 

04h flush on disk write if any lock set during 

write 

OSh flush on all reads if file written 
AL = new state (00h off, 01h on) 
Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27), 
See Also: Function 26h Subfunctions 00h and 06h 


INTERRUPT 7Fh - Function 26h, Subfunction 06h 
CANCEL FLUSH ON WRITE 


Purpose: Stop flushing buffers on disk writes. 

Available on: All machines, Restrictions: Alloy NTNX must be installed. 
Registers at call: Return Registers: n/a 

AH = 26h 

CL = 06h 

Details: This function cancels the flags set by Function 26h Subfunctions 03h and 04h 

Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27), 

See Also: Function 26h Subfunction 00h 


INTERRUPT 7Fh - Function 30h 
GET PORT INFORMATION 


Purpose: Determine whether a port is in use and where it is physically located. 


Available on: All machines. 
Registers at call: 

AH = 30h 

CX = MW386 port number 
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Restrictions: Alloy MW386 must be installed. 
Return Registers: 
AL = FFh if port not found 
else driver unit number 
BL = port mode 
BH = port type 
02h remote 
DH = owner's machine ID 
DL = owner's user ID 


Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 


See Also: INT 17h Function 8Bh 


INTERRUPT 7Fh - Function 31h 
CHECK PORT ASSIGNMENT 


Purpose: unknown. This function is not described in the MW386 v2.0 documentation. 


Available on: All machines. 


Registers at call: 

AH = 3th 

unknown. 

Conflicts: None known. 


INTERRUPT 7Fh - Function 37h 
GET SEMAPHORE TABLE 


Purpose: Determine the adderss of the semaphore table. 


Available on: All machines. 
Registers at call: 

AH = 37h 

Conflicts: None known. 


INTERRUPT 7Fh - Function 37h 

DUMP STRING TO TERMINAL 

Purpose: Display the specified string on the terminal. 
Available on: All machines. 


Registers at call: 
AH = 37h 
DS:DX -> ASCIZ string to display 


Restrictions: Alloy MW386 version 1.x must be 
installed. 
Return Registers: unknown. 


Restrictions: Alloy NTNX host must be installed. 
Return Registers: 
ES:AX -> semaphore table 


Restrictions: Must be running under Alloy ANSK or 
on an NTNX slave. 
Return Registers: n/a 


Details: If the string is empty, a terminal update will be forced. 


Conflicts: None known. 


INTERRUPT 7Fh « Function 38h 
SET NEW TERMINAL DRIVER 


Purpose: Specify the terminal driver to use for the current user. 


Available on: All machines. 


Registers at call: 

AH = 38h 

AL = new terminal driver number 
FFh dummy driver 
FEh current driver 
FDh load new driver 

DS:SI -> new driver 


Restrictions: Must be running under MW386 or on an 
Alloy NTNX slave. 
Return Registers: n/a 
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Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 
See Also: Function 39h 


INTERRUPT 7Fh - Function 39h 
SET TERMINAL DRIVER FOR ANOTHER USER 


Purpose: Specify which terminal driver to install on the next reboot of the indicated user. 


Available on: All machines. Restrictions: Alloy MW386 must be installed. 
Registers at call: Return Registers: 

AH = 39h CF set if invalid user number 

AL = new terminal driver number CF clear if successful 


DL = user number (FFh = caller) 

DH = machine number if DL <> FFh 

Details: This call is only available to supervisors. 

Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 
See Also: Function 38h 


INTERRUPT 7Fh - Function 3Ah 
GET TERMINAL PARAMETERS 


Purpose: Obtain the current terminal parameters for the specified user. 


Available on: All machines. Restrictions: Alloy MW386 must be installed. 
Registers at call: Return Registers: 

AH =3Ah CF clear if successful 

DL = user number (FFh = caller) AH = terminal driver number 

DH = machine number AL = baud rate (00h = 38400, O1h = 19200, etc) 


CL = parity (00h none, 01h even, 02h odd) 
CH = handshaking (00h none, 01h XON/XOFF, 
02h DTR/DSR, 03h XPC) 
CF set if invalid user number 
Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 
See Also: Function 3Bh 


INTERRUPT 7Fh - Function 3Bh 
SET TERMINAL PARAMETERS 


Purpose: Modify the terminal parameters for the specified user. 


Available on: All machines. Restrictions: Alloy MW386 must be installed. 
Registers at call: Return Registers: 
AH = 3Bh CF set if invalid user number 


AL = baud rate (00h = 38400, 01h = 19200, etc) | 
CL = parity (00h none, 01h even, 02h odd) 
CH = handshaking (00h none, 01h XON/XOFF, 02h 
DTR/DSR, 03h XPC) 
DL = user number (FFh = caller) 
DH = machine number for user 
Details: This call is only available to supervisors, The new parameters will take effect immediately if the user's 
terminal has not been started, else Function 3Dh must be called to post the changes. 
Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 
See Also: Functions 3Ah and 3Dh 


INTERRUPT 7Fh - Function 3Ch 
ENABLE/DISABLE AUTOBAUD DETECT 


Purpose: Specify whether MW386 should attempt the autobaud detection sequence for the specified user's terminal. 
Available on; All machines. Restrictions: Alloy MW386 must be installed. 
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Registers at call: Return Registers: 

AH =3Ch CF set if invalid user number 
AL = new state 00h disabled, 01h enabled 

DL = user number (FFh = caller) 

DH = machine number for user 

Details: This function is only available to supervisors. 

Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 

See Also: Function 3Dh 


INTERRUPT 7Fh - Function 30h 
POST TERMINAL CONFIGURATION CHANGES 


Purpose: Permanently store changes in terminal type or parameters. 


Available on: All machines. Restrictions: Alloy MW386 must be installed. 
Registers at call: Return Registers: n/a 
AH = 3Dh 


Details: This function should be called whenever a program changes the terminal type or its parameters. 
Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 
See Also: Function 3Bh 


INTERRUPT 7Fh - Function 41h 


LOCK FILE FOR USER 
Purpose: Request exclusive read/write access to the specified file. 
Available on: All machines. Restrictions: Alloy NTNX must be installed. 
Registers at call: Return Registers: 
AH =4Ih AL = status 
AL = user JD 00h successful 9 
DS:DX -> ASCIZ filename Oth invalid function " 
02h already locked 
03h unable to lock 
04h lock table full 


Conflicts; Halo88 API (chapter 5), ClusterShare access (chapter 27). 
See Also: Functions 00h and 42h, 386/MultiWare Functoin 41h 


INTERRUPT 7Fh - Function 41h 


LOCK SEMAPHORE FOR USER 

Purpose: Request per-user exclusive access to a resource, 

Available on; Ali machines. Restrictions: Alloy MW386 must be installed. 
Registers at call: Return Registers: 

AH = 41h AL = status 

AL = user ID 00h successful 

DS:DX -> ASCIZ semaphore name O1h invalid function 


02h semaphore already locked 
03h unable to lock semaphore 
04h semaphore space exhausted 
Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 
See Also: Functions 00h and 42h 


INTERRUPT 7Fh - Function 42h 


UNLOCK FILE FOR USER 

Purpose: Permit others access to the specified file. 

Available on: All machines. Restrictions: Alloy NTNX must be installed. 
Registers at call: Return Registers: 


AH = 42h AL = status 
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AL = user ID 00h successful 

DS:DX -> ASCIZ filename Olh invalid function 
02h already locked 
03h unable to lock 
04h lock table full 


Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 
See Also: Functions 00h and 41h, 386/MultiWare Function 42h 


INTERRUPT 7Fh - Function 42h 
UNLOCK SEMAPHORE FOR USER 


Purpose: Indicate the the specified resource is once again available for use by the given user. 


Available on: All machines, Restrictions: Alloy MW386 must be installed. 
Registers at call: Return Registers: 

AH = 42h AL = status 

AL = user ID 00h successful 

DS:DX -> ASCIZ semaphore name Oth invalid function 


03h unable to unlock semaphore 
Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 
See Also: Functions 02h and 41h, NTNX Function 42h 


INTERRUPT 7Fh - Function 4Eh 
SET ERROR MODE 


Purpose: Control the display of critical (Abort, Retry, Fail) error messages. 
Available on: All machines, Restrictions: Alloy MW386 version 2.0 or higher 
must be installed. 
Registers at call: Return Registers: 
AH =4Eh AL = status 
AL = error mode flags 00h successful 
bit 0: display critical disk errors 
1; display sharing errors 
DX = 4E58h ("NX") 
Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 
See Also: Function 4Fh 


INTERRUPT 7Fh - Function 4Fh 
SET FCB MODE 


Purpose: Specify the sharing mode with which FCBs will be opened. 
Available on: All machines. Restrictions: Alloy MW386 version 2.0 or higher 
must be installed, 
Registers at call: Return Registers: 
AH = 4Fh AL = status 
AL = FCB mode 00h successful 
02h read/write compatibility 
42h read/write shared 
DX = 4E58h ("NX") 
Conflicts: None known. 


INTERRUPT 7Fh - Function 81h 
ATTACH DEVICE FOR USER 


Purpose: Request exclusive access to the specified device. 

Available on: All machines, Restrictions: Alloy NTNX must be installed. 
Registers at call: Return Registers: n/a 

AH = 8th 
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AL = user JD 

DS:DX -> ASCIZ device name 

Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 
See Also: Function 82h 


INTERRUPT 7Fh - Function 82h 

RELEASE DEVICE FOR USER 

Purpose: Permit others access to the specified device. 

Available on: All machines. Restrictions: Alloy NTNX must be installed. 
Registers at call: Return Registers: n/a 

AH = 82h 

AL = user ID 

DS:DX -> ASCIZ device name 

Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 

See Also: Function 81h 


INTERRUPT 7Fh - Function Adh 


GET USER NAME 

Purpose: Determine the name corresponding to the given user number. 

Available on: All machines. Restrictions: Alloy MW386 must be installed. 
Registers at call: Return Registers: 

AH = AOh CF set if invalid user number 


DL = user number (FFh = caller) 

DH = machine number for user 

ES:DI -> 17-byte buffer for ASCIZ user name 

Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 
See Also: Functions 03h and Alh 


INTERRUPT 7Fh - Function Ath 


GET MACHINE, USER, AND PROCESS NUMBER 


Purpose: Determine the machine on which the caller is running, which user is running the calling program, and the 
program's process number, 


Available on: All machines. Restrictions: Alloy MW386 must be installed. 
Registers at call: Return Registers: 
AH=Alh AL = process number 


DL = user number 

DH = machine number 
Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 
See Also: Functions 03h, AOh, and A2h 


INTERRUPT 7Fh - Function A2h 
GET USER PRIVILEGE LEVEL 


Purpose: Determine the specified user's operating privileges. 
P P' 8 P 8 


Available on: All machines. Restrictions: Alloy MW386 must be installed. 
Registers at call: Return Registers: 
AH = A2h CF clear if successful 
DL = user number (FFh = caller) AL = privilege level 
DH = machine number for user 00h supervisor 
Oth high 
02h medium 
03h low 


CF set if invalid user number 
Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 
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See Also: Functions Alh and A3h 


INTERRUPT 7Fh - Function A3h 
GET USER LOGIN STATE 


Purpose: Determine whether the specified user is currently logged onto the indicated machine. 


Available on: All machines. 
Registers at call: 

AH = A3h 

DL = user number 

DH = machine number for user 


Restrictions: Alloy MW386 must be installed. 


Return Registers: 
CF clear if successful 
AL = login state 
00h never logged in 
Olh currently logged out 
03h currently logged in 
CF set if invalid user number or user not 
active 


Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 


See Also: Function A2h 


INTERRUPT 7Fh - Function A4h 
VERIFY USER PASSWORD 


Purpose: Determine whether the specified string is the password for the user running the calling program. 


Available on: All machines. 

Registers at call: 

AH = A4h 

DS:DX -> ASCIZ password (null-padded to 16 
bytes) 

Conflicts: None known, 


INTERRUPT 7Fh - Function A5h 
GET/SET USER STATUS 


Purpose: Read or write user status information, 
Available on: All machines. 
Registers at call: 
AH = A5h 
DI = machine number and user number 
AL = function 
00h get status 


O1N set status 
BX = user flags (see above) 
CL = scan code for task manager hotkey 
CH = scan code for spooler hotkey 
DL = scan code for task swapper hotkey 
DH = modifier key status 


Restrictions: Alloy MW386 must be installed. 


Return Registers: 
AL = 00h if accepted 
else invalid password 


Restrictions: Alloy MW386 must be installed. 


Return Registers: 
CF set if invalid user number 


BX = user flags 

bit 5: allow messages 
CL = scan code for task manager hotkey 
CH = scan code for spooler hotkey 
DL = scan code for task swapper hotkey 
DH = modifier key status 


Details: The caller must have supervisor privilege to set another user's status, 


Conflicts: None known, 


INTERRUPT 7Fh - Function BOh 
RELEASE ALL SEMAPHORES FOR USER 


Purpose: Free locks on all resources used by the indicated user. 
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Available on: All machines. Restrictions: Alloy NTNX or MW386 must be 
installed. 

Registers at call: Return Registers: n/a 

AH = BOh 


AL = user number 

DS = code segment 

Details: MW386 ignores AL and DS; it releases all semaphores locked using the INT 67h or INT 7Fh locking 
functions. 

Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 

See Also: Functions Bih, B2h, B3h, and B4h 


INTERRUPT 7Fh - Function Bih 
RELEASE NORMAL SEMAPHORES FOR USER 


Purpose: Free locks on the resources used by the indicated user. 


Available on: All machines. Restrictions: Alloy NINX or MW386 must be 
installed. 

Registers at call: Return Registers: n/a 

AH=Blh 


AL = (bits 7-5) 000 
(bits 4-0) user ID 
Details: MW386 ignores AL; it releases all semaphores locked using the INT 67h or INT 7Fh locking functions. 
Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 
See Also: Functions BOh, B2h, B3h, and B4h 


INTERRUPT 7Fh - Function B2h 
RELEASE MESSAGES FOR USER 


Purpose: Not specified in documentation; presumably discards all pending messages. 


Available on: All machines. Restrictions: Alloy NTNX must be installed. 
Registers at call: Return Registers: n/a 
AH =B2h 
AL = (bits 7-5) 001 
(bits 4-0) user ID 


Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27), 
See Also: Functions BOh, Bih, B3h, and B4h 


INTERRUPT 7Fh - Function B3h 


RELEASE FILES FOR USER 

Purpose: Not specified in documentation; presumably removes all locks requested with Function 41h. 
Available on: All machines. Restrictions: Alloy NTNX must be installed. 
Registers at call: Return Registers: n/a 

AH = B3h 


AL = (bits 7-5) 010 

(bits 4-0) user ID 
Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 
See Also: Functions BOh, Bih, B2h, and B4h 


INTERRUPT 7Fh - Function Bah 
RELEASE DEVICES FOR USER 


Purpose: Not specified in documentation; presumably removes all attcchments made with Function 81h. 


Available on: All machines. Restrictions: Alloy NTNX must be installed. 
Registers at call: Return Registers: n/a 
AH = B4h 


AL = user ID 
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Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 
See Also: Functions BOh, Bih, B2h, and B3h 


INTERRUPT 7Fh - Function C3h 
WRITE BYTE TO TERMINAL AUX PORT 


Purpose: Output a character directly to the caller's terminal port. 


Available on: All machines. Restrictions: Alloy MW386 must be installed. 
Registers at call: Return Registers: 

AH = C3h CF clear if successful 

AL = byte to write CF set on error 


Conflicts; Halo88 API (chapter 5), ClusterShare access (chapter 27). 
See Also: Function Cél 


INTERRUPT 7Fh - Function C5h 





CHANGE CONSOLE MODE 
Purpose: Switch into or out of data communications mode. 
Available on: All machines. Restrictions: Alloy MW386 must be installed. 
Registers at call: Return Registers: 
AH=C5Sh CF clear if successful 
AL = new console mode AL = prior console mode 
00h keyboard indirect CF set on error (caller is not remote user) 


Olh keyboard direct 

02h data handshake enforced 

03h no data handshake 
Details: Modes 2 and 3 may be used for input through the console port; no video output should be performed in 
these modes. 
Conflicts: None known, 


INTERRUPT 7Fh - Function C6h 
WRITE BYTE TO CONSOLE PORT 


Purpose: Output a character directly to the console port without any translations by the terminal driver. 


Available on: All machines. Restrictions: Alloy MW386 must be installed, 
Registers at call: Return Registers: 

AH = C6h CF clear if successful 

AL = byte to write CF set on error (caller is not remote user) 


Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27), 
See Also: Functions C3h and C7h 


INTERRUPT 7Fh - Function C7h 


READ CONSOLE DATA BYTE 

Purpose: Get input from the console while in data mode. 

Available on: All machines. Restrictions: Alloy MW386 must be installed. 
Registers at call: Return Registers: 

AH =C7h CF clear if successful 


AL = byte read 
CF set on error (no data available or caller is 
not remote user) 
Details: This function may be used to read data after placing the console in mode 2 or 3 {see Function C5h), 
Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 
See Also: Functions C5h, C6h, and C8h 
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INTERRUPT 7Fh - Function C8h 
READ CONSOLE DATA INTO BUFFER 


Purpose: Input multiple bytes directly from the console port while in data mode. 


Available on: All machines. Restrictions: Alloy MW386 must be installed. 
Registers at call: Return Registers: 
AH =C8h CF clear if successful 
AL = maximum bytes to read CX = number of bytes read 
ES:D]I -> buffer for console data CF set on error (caller is not remote user) 
Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 
See Also: Function C7h 
INTERRUPT 7Fh - Function CFh 
REBOOT USER PROCESSOR 
Purpose: Reset the specified user processor. 
Available on: All machines. Restrictions: Alloy NTNX must be installed. 
Registers at call: Return Registers: n/a 
AH = CFh 
DS:DX -> ASCIZ string containing user number to 
be reset 
Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 
See Also: Function D6h 
INTERRUPT 7Fh - Function Déh 
RESET NETWORK EXECUTIVE 
Purpose: Flush all disk buffers and reinitialize the network operation, 
Available on: All machines. Restrictions: Alloy MW386 must be installed. 
Registers at call: Return Registers: 
AH = D6h never if succesful 


DS:DX -> reset packet (Table 18-13) 

Details: All users will be shut down immediately if this function is successful. 
Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 

See Also: Function CFh 


Table 18-13. Format of reset packet: 


Offset Size Description 

00h DWORD _ reset code (60606060h) 

04h 16 BYTEs ASCIZ supervisor password padded with nulls 

INTERRUPT 7Fh - Function D7h 

POST EVENT 

Purpose: Post an event for the specified user. 

Available on: All machines. Restrictions: Alloy MW386 must be installed. 
Registers at call: Return Registers: n/a 

AH = D7h 


AL = user number (if local event) 
DX = event number 
Conflicts: None known. 


INTERRUPT 7Fh - Function D8h 
FLUSH DISK BUFFERS 


Purpose: Force all disk buffers to be written out immediately. 


\ 
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Available on: All machines. Restrictions: Alloy MW386 must be installed. 
Registers at call: Return Registers: 
AH = D8h CF set on error 


Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 
See Also: DOS INT 21h Function ODh (chapter 8), DOS INT 21h Function 5Dh Subfunction 01h (chapter 8), 
Network Redirector INT 2Fh Function 11h Subfunction 20h (chapter 19) 


INTERRUPT 7Fh - Function DBh 
GET MW386 INVOCATION DRIVE 


Purpose: Determine the drive from which MW386 was started, in order to find system data files. 


Available on: All machines. Restrictions: Alloy MW386 version 2.0 or higher 
must be installed. 
Registers at call: Return Registers: 
AH =DBh AL = drive from which MW386 was started 
(2=C:,3=D:,ete) 


Conflicts: None known. 


INTERRUPT 7Fh - Function EOh 


CREATE DOS TASK 
Purpose: Initiate a new task with the specified amount of memory. 
Available on: All machines, Restrictions: Alloy MW386 must be installed. 
Registers at call: Return Registers: 
AH = E0h CF clear if successful 
AL = memory size (O0h=128K, 01h=256K, AL = task create ID 
02h=384K, 03h=512K, 04h=640K) CF set on error 


DS:DX -> ASCIZ task name (max 16 bytes) 

Details: Only foreground DOS tasks can use this function. 
Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 
See Also: Functions Elh, E2h, E3h, E6h, and E7h 


INTERRUPT 7Fh - Function Eth 
GET DOS TASK PID FROM CREATE ID 


Purpose: Determine the actual process number of a recently-created task, 


Available on: All machines. Restrictions: Alloy MW386 must be installed. 
Registers at call: Return Registers: 

AH=Elh AL = DOS process number 

AL = create ID (from Function EOh) CL = memory size (0Oh=128K, 01h=256K, 02h=384K, 


03h=512K, 04h=640K) 
Details: This function should not be called immediately after creating a new DOS task, since the new task is being 
initialized by a concurrent process. 
Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 
See Also: Functions EOh and E2h 


INTERRUPT 7Fh - Function E2h 


SWITCH TO NEW DOS TASK 

Purpose: Place the current task in the background and move the specified task to the foreground, 

Available on: All machines. Restrictions: Alloy MW386 must be installed. 
Registers at call: Return Registers: 

AH =E2h CF set on error (invalid process number or caller not 
AL = DOS process number (from Function Elh) foreground task) 


Details: This function may only be called by a foreground task, 
Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 
See Also: Functions EQh and Elh 
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INTERRUPT 7Fh - Function E3h 

CHANGE NAME OF DOS TASK 

Purpose: Rename a running DOS task. 

Available on: All machines. Restrictions: Alloy MW386 must be installed. 
Registers at call: Return Registers: 

AH=E3h CF set on error (invalid process number) 
---VLX 

AL = user number 

n--V2.0+ 

BH = user number 

BL = task number 

DS:DX -> ASCIZ task name 

Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 

See Also: Functions E0h, E4h, and E5h 


INTERRUPT 7Fh - Function E4h 
GET TASK NAME FROM PROCESS NUMBER 


Purpose: Determine the name corresponding to the given process number, 


Available on: All machines. Restrictions: Alloy MW386 must be installed. 
Registers at call: Return Registers: 

AH = E4h CF clear if successful 

--VLLX CL = memory size (O0h=128K, 01h=256K, 
AL = user number 02h=384K, 03h=512K, 04h=640K) 
---V2.0+ DX = task flags bit 7: MSDOS process 

BH = user number ES:DI buffer filled 

BL = task number CF set on error (invalid process number) 


ES:DI -> buffer for task name 
Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 
See Also: Functions E3h and ESh 


INTERRUPT 7Fh - Function E5h 
GET PROCESS NUMBER FROM TASK NAME 


Purpose: Determine the process number corresponding to the given name. 


Available on: All machines. Restrictions: Alloy MW386 must be installed. 
Registers at call: Return Registers: 

AH = ESh CF clear if successful 

DS:DX -> ASCIZ task name AL = DOS process number 

BH = user number CL = memory size (O0h=128K, 01h=256K, 


02h=384K, 03h=512K, 04h=640K) 
CF set on error (no match for name) 
Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 
See Also: Functions E3h and E4h 


INTERRUPT 7Fh - Function E6h 
GET NUMBER OF AVAILABLE USER TASKS 


Purpose: Determine the total number of DOS tasks for the current user. 


Available on: All machines. Restrictions: Alloy MW386 must be installed. 
Registers at call: Return Registers: 
AH = E6h AX = number of processes available to current user 


Conflicts; Halo88 API (chapter 5), ClusterShare access (chapter 27). 
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See Also: Function EOh 
INTERRUPT 7Fh - Function E7h 


REMOVE DOS TASK 

Purpose: Terminate the specified task. 

Available on: All machines. Restrictions: Alloy MW386 must be installed. 
Registers at call: Return Registers: 

AH = E7h CF set on error (invalid process number or first 
AL = DOS process number process) 


Details: This function can only be called by a foreground task. 
Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 
See Also: Function EOh 


INTERRUPT 7Fh - Function E8h 


DOS TASK DELAY 

Purpose: Suspend the calling task for the specified interval. 

Available on: All machines. Restrictions: Alloy MW386 must be installed, 
Registers at call: Return Registers: n/a 

AH = E8h 


CX = delay time in milliseconds 

Details: A delay of 0 may be used to surrender the current time slice. 

Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27), 

See Also: TopView INT 15h Function 10h Subfunction 00h (chapter 15), DoubleDOS INT 21h Function EEh 
(chapter 17), MS Windows INT 2Fh Function 16h Subfunction 80h (chapter 14) 


INTERRUPT 7Fh - Function FOh 
RESTRICT DIRECTORY TO GROUP 


Purpose: Permit only a specified group of users to access the given directory. 


Available on: All machines. Restrictions: Alloy MW386 must be installed. 
Registers at call: Return Registers: 

AH = FOh CF clear if successful 

AL = group number AX = status 

DS:DX -> ASCIZ directory name 0002h directory not found 


0003h directory not found 
000Sh directory in use, cannot be restricted 1 
02xxh restricted to group xxh 
CF set on error 
Details: The restriction on the directory may be removed by calling this function with group 0, then using Function 
Fh to assign the directory to group 0. 
See Also: Functions Fih, F2h, and F3h 


INTERRUPT 7Fh - Function Fih 
ASSIGN DIRECTORY TO GROUP 


Purpose: Permanently mark the given directory as owned by the specified group. 


Available on; All machines, Restrictions: Alloy MW386 must be installed. 
Registers at call: Return Registers: n/a 
AH = Flh 


AL = group number 

DS:DX -> ASCIZ directory name 

Details: This call performs permanent assignment to a group; no immediate action is taken unless the directory has 
been restricted with Function FOh. It may be used to restrict a nonexistent directory. 

Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 

See Also: Function F0h 
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INTERRUPT 7Fh - Function F2h 
READ RESTRICTED DIRECTORY ENTRY 


Purpose: Retrieve an entry from the list of restricted directories. 


Available on: All machines. Restrictions: Alloy MW386 must be installed, 
Registers at call: Return Registers: 

AH = F2h CF clear if successful 

CX = entry number buffer filled with 63-byte directory info and 1-byte 


ES:D] -> 64-byte buffer group number 
CF set on error (invalid entry) 


Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 
See Also: Functions FOh and F3h 


INTERRUPT 7Fh - Function F3h 
READ RESTRICTED DIRECTORY ENTRY FOR GROUP 


Purpose: Retrieve an entry from the list of restricted directories belonging to the specified group. 


Available on: All machines. Restrictions: Alloy MW386 must be installed. 
Registers at call: Return Registers: 

AH = F3h CF clear if successful 

AL = group number CX = next entry number 

CX = entry number buffer filled with 63-byte directory info and 1-byte 
ES:DI -> 64-byte buffer group number 


CF set on error (no more matching entries) 
Details: This call is like Function F2h, but only returns directories belonging to the specified group. 
Conflicts: Halo88 API (chapter 5), ClusterShare Access (chapter 27). 
See Also: Function F2h 


INTERRUPT 7Fh - Function F8h 


ASSIGN USER TO GROUP 

Purpose: Make the specified user a member of the indicated group. 

Available on: All machines. Restrictions: Alloy MW386 must be installed. 
Registers at call: Return Registers: 

AH = F8h CF clear if successful 

AL = group number CF set on error (user already in maximum number of 
DL = user number groups) 


DH = machine number (currently 00h) 

Details: Each user is allowed eight group assignments. 

Conflicts: Halo88 API (chapter 5), ClusterShare Access (chapter 27), 
See Also: Functions F9h and FAh 


INTERRUPT 7Fh - Function Foh 


REMOVE USER FROM GROUP 

Purpose: End the specified user's membership in the indicated group. 

Available on: All machines. Restrictions: Alloy MW386 must be installed. 
Registers at call: Return Registers: 

AH = F9h CF set if failed 


AL = group number 

DL = user number 

DH = machine number (currently 00h) 

Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 
See Also: Functions F8h and FAh 
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INTERRUPT 7Fh - Function FAh 


GET USER GROUP LIST 

Purpose: Determine to which groups the specified user belongs. 

Available on: All machines. Restrictions: Alloy MW386 must be installed. 
Registers at call: Return Registers: 

AH =FAh CX = number of groups 

DL = user number ES:DI buffer filled with group numbers 


DH = machine number (currently 00h) 

ES:DI -> 16-byte buffer for group list 

Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 
See Also: Functions F8h and F9h 


INTERRUPT 7Fh - Function FBh 


ASSIGN GROUP NAME 

Purpose: Specify a name for the indicated group. 

Available on: All machines. Restrictions: Alloy MW386 must be installed, 
Registers at call: Return Registers: n/a 

AH = FBh 


CL = group number 

ES:DI -> ASCIZ group name (max 17 bytes) 

Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27), 
See Also: Function FCh 


INTERRUPT 7Fh - Function FCh 


GET GROUP NAME 

Purpose: Determine the name of the indicated group. 

Available on: All machines. Restrictions: Alloy MW386 must be installed. 
Registers at call: Return Registers: 

AH = FCh ES:DI buffer filled 


CL = group number 

ES:DI -> 17-byte buffer for ASCIZ name 

Details: If the group has not been named, "(unnamed)" is returned, 
Conflicts: Halo88 API (chapter 5), ClusterShare access (chapter 27). 
See Also: Function FBh 


INTERRUPT ECh 
Used by Alloy NTNX 


Purpose: unknown. 

Available on: All machines. Restrictions: Alloy NTNX must be installed. 
Registers at call: unknown. Return Registers: unknown. 

Conflicts: Exact (chapter 36). 





Chapter 1 ) 


Network Redirector and CD-ROM Extensions 


This chapter describes the interrupt functions used by the network redirector (including the IFSFUNC driver supplied 
as part of DOS versions 4,0x), the CD-ROM extensions to MS-DOS, and certain additional network redirection ser- 
vices. The CD-ROM extensions (MSCDEX) include a network redirector, so the redirector calls apply to the exten- 
sions even though the CD-ROM extensions are not explicitly mentioned on each redirector call. 

The functions are all included in the Multiplex Interrupt, 2Fh; they are described in sequence by function and sub- 
function. In the case of the REDIR/REDIRIEFS functions, this splits the application since it uses both the lowest and 
the highest functions covered in this chapter. 


INTERRUPT 2Fh - Function 02h, Subfunction 00h 
internal - INSTALLATION CHECK 


Purpose: Determine whether the PC LAN Program REDIR or REDIRIFS is installed. 





Available on: Ail machines. Restrictions: none. 
Registers at call: Return Registers: 
AX = 0200h AL = FFh if installed 


Conflicts: None known. 


INTERRUPT 2Fh - Function 02h, Subfunctions 01h through FFh 
internal - Unknown Functions 


Purpose: unknown. 


Available on; All machines. Restrictions: PC LAN Program REDIR or REDIRIFS 
must be installed. 
Registers at call: Return Registers: 
AX =0201h nothing 
AX = 0202h nothing 
other unknown. 
AX = 0203h nothing 
AX = 0204h nothing 
other unknown. 
AX = 02xxh unknown. 


other unknown. 
Details: Subfunctions 01h and 02h appear to be paired opposites, as do Subfunctions 03h and 04h. These four sub- 
functions are called by DOS 3.3+ PRINT.COM. 
Conflicts: None known. 


INTERRUPT 2Fh - Function 11h, Subfunction 00h 
MSCDEX INSTALLATION CHECK 


Purpose: Determine whether the Microsoft CD-ROM Extensions are installed. 


Available on: All machines. Restrictions: none. 

Registers at call: Return Registers: 

AX = 1100h AL = 00h not installed, OK to install 
STACK: WORD DADAh STACK unchanged 
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= 01h not installed, not OK to install 
STACK unchanged 
= FFh installed 
STACK: WORD ADADh 
Conflicts: Network Redirector. 


INTERRUPT 2Fh - Function 11h, Subfunction 00h 
NETWORK REDIRECTOR INSTALLATION CHECK 


Purpose: Determine whether a Network Redirector is installed. 


Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AX = 1100h AL= 00h not installed, OK to install 


=OlIh not installed, not OK to install 

= FFh installed 
Details: This function is called by the DOS 3.1+ kernel. In DOS 4.0x only, the 1ixxh calls are all in IFSFUNC.EXE 
rather than in the PC LAN Program redirector. 
Conflicts: MSCDEX (MS CD-ROM Extensions). 


INTERRUPT 2Fh - Function 11h, Subfunction Oth 
REMOVE REMOTE DIRECTORY 


Purpose: Remove the specified directory on the network or installable file system drive, 


Available on: DOS 3.1 or higher. Restrictions: Network redirector or IFS driver must be 
installed. 
Registers at call: Return Registers: 
AX = 110th CF set on error 
SS = DOS DS AX = DOS error code (see INT 21h Function 59h, 
SDA first filename pointer -> fully-qualified chapter 8) 
directory name CF clear if successful 


SDA CDS pointer -> current directory structure for 
drive with directory 
Details: This function is called by the DOS 3.1+ kernel, 
Conflicts: None known. 
See Also: Function 1 1h Subfunctions 03h and 05h, INT 21h Functions 3Ah and 60h (chapter 8) 


INTERRUPT 2Fh - Function 11h, Subtunction 02h 
REMOVE REMOTE DIRECTORY 


Purpose: Remove the specified directory on the network or installable file system drive. 


Available on: DOS 4.x only. Restrictions: IFSFUNC.EXE must be installed. 
Registers at call: Return Registers: 
AX = 1102h CF set on error 
SS = DOS DS AX = DOS error code (see INT 21h Function 59h, 
SDA first filename pointer -> fully- qualified chapter 8) 

directory name CF clear if successful 


SDA CDS pointer -> current directory structure for 
drive with directory 
Details: This call appears to be identical to Function 11h Subfunction O1h. 
Conflicts: None known. 
See Also: Function | th Subfunction 01h 


INTERRUPT 2Fh - Function 11h, Subfunction 03h 
MAKE REMOTE DIRECTORY 


Purpose: Create the specified directory on the network or installable file system drive if it does not already exist. 


Available on: DOS 3.1 or higher. 


Registers at call: 

AX =1103h 

SS = DOS DS 

SDA first filename pointer -> fully-qualified 
directory name 

SDA CDS pointer -> current directory structure for 
drive with directory 


Details: This function is called by the DOS 3.1+ kernel. 


Conflicts: None known. 
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Restrictions: Network redirector or IFS driver must be 
installed. 
Return Registers: 


CF set on error 
AX = DOS error code (see INT 21h Function 59h, 


chapter 8) 
CF clear if successful 


See Also: Function 11h Subfunctions 01h and 05h, INT 21h Functions 39h and 60h (chapter 8) 


INTERRUPT 2Fh - Function 11h, Subfunction 04h 


MAKE REMOTE DIRECTORY 


Purpose: Create the specified directory on the network or ins! 


Available on: DOS 4.x only. 

Registers at call: 

AX = 1104h 

SS = DOS DS 

SDA first filename pointer -> fully- qualified 
directory name 

SDA CDS pointer -> current directory structure for 
drive with directory 


tallable file system drive if it does not already exist. 
Restrictions: IFSFUNC.EXE must be installed. 
Return Registers: 
CF set on error 
AX = DOS error code (see INT 21h Function 59h, 
chapter 8) 
CF clear if successful 


Details: This call appears to be identical to Function 11h Subfunction 03h. 


Conflicts: None known. 
See Also: Function 11h Subfunction 03h 


INTERRUPT 2Fh - Function 11h, Subfunction 05h 


CHDIR 


Purpose: Specify the current directory on the indicated network or installable file system drive. 


Available on: DOS 3.1 or higher. 


Registers at call: 

AX = 1105h 

SS =DOS DS 

SDA first filename pointer -> fully-qualified 
directory name 

SDA CDS pointer -> current directory structure for 
drive with directory 


Restrictions: Network redirector or IFS driver must be 
installed. 
Return Registers: 
CF set on error 
AX = DOS error code (see INT 21h Function 59h, 
chapter 8) 
CF clear if successful 
CDS updated with new path 


Details: This function is called by the DOS 3.1+ kernel. The directory string in the CDS should not have a 
terminating backslash unless the current directory is the root. 


Conflicts: None known. 


See Also: Function 11h Subfunction 01h, Function 11h Subfunction 03h, INT 21h Functions 3Bh and 60h (chapter 


8) 


INTERRUPT 2Fh - Function 11h, Subfunction 06h 


CLOSE REMOTE FILE 


Purpose: Close the specifed file on the network or installable file system drive. 


Available on: DOS 3.1 or higher. 


Registers at call: 
AX = 1106h 


Restrictions: Network redirector or IFS driver must be 
installed. 

Return Registers: 

CF set on error 
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ES:DI -> SFT AX = DOS error code (see INT 21h Function 59h, 
SFT DPB field -> DPB of drive containing file chapter 8) 
CF clear if successful 
SFT updated (except handle count, which DOS 
manages itself) 
Details: This function is called by the DOS 3.1+ kernel. 
Conflicts: None known. 
See Also: Function 12h Subfunctions 01h and 27h, DOS INT 21h Function 3Eh (chapter 8) 


INTERRUPT 2Fh - Function 11h, Subfunction 07h 


COMMIT REMOTE FILE 
Purpose: Force all buffered data for the specified file to be written to the disk and the directory entry to be updated. 
Available on: DOS 3.1 or higher. Restrictions: Network redirector or IFS driver must be 
installed. 
Registers at call: Return Registers: 
AX =1107h CF set on error 
ES:DI -> SFT AX = DOS error code (see INT 21h Function 59h, 
SFT DPB field -> DPB of drive containing file chapter 8) 
CF clear if successful 
all buffers for file flushed 
directory entry updated 


Details: This function is called by the DOS 3.1+ kernel. 
Conflicts: None known. 
See Also: INT 21h Function 68h (chapter 8), INT 21h Function 5Dh Subfunction 01h (chapter 8) 


INTERRUPT 2Fh - Function 11h, Subfunction 08h 


READ FROM REMOTE FILE 

Purpose: Retrieve data from the specified file on the network or installable file system drive. 

Available on: DOS 3.1 or higher. Restrictions: Network redirector or IFS driver must be 
installed. 

Registers at call: Return Registers: 

AX = 1108h CF set on error 

ES:DI -> SFT AX = DOS error code (see INT 21h Function 59h, 

SFT DPB field -> DPB of drive containing file chapter 8) 

CX = number of bytes CF clear if successful 

SS = DOS DS CX = number of bytes read (0000h = end of file) 

SDA DTA field -> user buffer SFT updated 


Details: This function is called by the DOS 3.1+ kernel. 

Conflicts: None known. 

See Also: Function 11h Subfunction 09h, Function 12h Subfunction 29h, INT 21h Function 3Fh (chapter 8), INT 
21h Function 5Dh Subfunction 06h (chapter 8) 


INTERRUPT 2Fh - Function 11h, Subfunction 09h 


WRITE TO REMOTE FILE 

Purpose: Write data to the specified file on the network or installable file system drive. 

Available on: DOS 3.1 or higher. Restrictions: Network redirector or IFS driver must be 
installed. 

Registers at call: Return Registers: 

AX = 1109h CF set on error 

ES:DI -> SFT AX = DOS error code (see INT 21h Function 59h, 


SFT DPB field -> DPB of drive containing file chapter 8) 


Network Redirector and CD-ROM Extensions 19-5 


CX = number of bytes CF clear if successful 
SS = DOS DS CX = number of bytes written 
SDA DTA field -> user buffer SFT updated 


Details: This function is called by the DOS 3.1+ kernel. 


Conflicts: None known. 
See Also: Function 11h Subfunction 07h, Function 11h Subfunction 08h, INT 21h Function 40h (chapter 8), INT 


21h Function 5Dh Subfunction 06h (chapter 8) 
INTERRUPT 2Fh - Function 11h, Subfunction OAh 


LOCK REGION OF FILE 

Purpose: Temporarily prohibit others from accessing the specified portion of the file. 

Available on: DOS 3.1 or higher. Restrictions: Network redirector or IFS driver must be 
installed. 

Registers at call: Return Registers: 

AX = 110Ah CF set on error 

BX = file handle AL = DOS error code (see INT 21h Function 59h, 

CX:DX = starting offset chapter 8) 

SI = high word of size STACK unchanged 

STACK: WORD low word of size 

ES:DI -> SFT 

SFT DPB field -> DPB of drive containing file 

SS = DOS DS 


Details: This function is called by the DOS 3.1+ kernel; the redirector is expected to resolve lock conflicts, DOS 4.0 
and higher also call this funetion to unlock the region, and do not use subfunction OBh, 


Conflicts: None known. 
See Also: Function 11h Subfunction OBh, INT 21h Function 5Ch (chapter 8) 


INTERRUPT 2Fh - Function 11h, Subfunction OBh 


UNLOCK REGION OF FILE 

Purpose: Permit others to access the specified portion of the indicated file. 

Available on: DOS 3.1 through 3.31 only. Restrictions: Network redirector or IFS driver must be 
installed. 

Registers at call: Return Registers: 

AX=110Bh CF set on error 

BX = file handle AL = DOS error code (see INT 2th Function 59h, 

CX:DX = starting offset chapter 8) 

SI = high word of size STACK unchanged 


STACK: WORD low word of size 

ES:DI -> SFT for file 

SFT DPB field -> DPB of drive containing file 

Details: This function is called by the DOS 3.x+ kemel. DOS 4.0 and higher call Function 0Ah instead to unlock the 
file. 

Conflicts: None known. 

See Also: Function 1 1h Subfunction OAh, INT 2{h Function 5Ch (chapter 8) 


INTERRUPT 2Fh - Function 11h, Subfunction 0Ch 
GET DISK SPACE 


Purpose: Determine the allocations units of the network or installable file system drive and how many clusters are 
free. 


Available on: DOS 3.1 or higher. Restrictions: Network redirector or IFS driver must be 
installed. 
Registers at call: Return Registers: 


AX =110Ch AL = sectors per cluster 
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ES:DI -> current directory structure for desired 
drive 


Details: This function is called by the DOS 3.1+ kernel, 
Conflicts: None known, 
See Also: INT 21h Function 36h {chapter 8) 


INTERRUPT 2Fh - Function 11h, Subfunction ODh 
Unknown Function 


Purpose: unknown. 

Available on: DOS 4.x only. 

Registers at call: 

AX = 110Dh 

SDA first filename pointer -> name of file 
other unknown. 


AH = media ID byte 

BX = total clusters 

CX = bytes per sector 

DX = number of available clusters 


Restrictions: IFSFUNC.EXE must be installed. 
Return Registers: unknown. 


Details: This call appears to be similar to Function 11h Subfunction OFh. 


Conflicts: None known. 
See Also: Function 11h Subfunction OFh 


INTERRUPT 2Fh - Function 11h, Subfunction OEh 
SET REMOTE FILE'S ATTRIBUTES 


Purpose: Specify new attribute bits for the given file on the network or installable file system drive. 


Available on: DOS 3.1 or higher. 


Registers at call: 

AX = 1L10Eh 

SS = DOS DS 

SDA first filename pointer -> fully-qualified name 
of file 

SDA CDS pointer -> current directory structure for 
drive with file 

STACK: WORD new file attributes 

Details: This function is called by the DOS 3.1+ kernel. 

Conflicts: None known. 


Restrictions: Network redirector or IFS driver must be 
installed, 
Return Registers: 
CF set on error 
AX = DOS error code (see INT 21h Function 59h, 
chapter 8) 
CF clear if successful 
STACK unchanged 


See Also: Function 11h Subfunction OFh, INT 21h Function 43h Subfunction 01h (chapter 8), INT 21h Function 60h 


(chapter 8) 


INTERRUPT 2Fh - Function 11h, Subfunction OFh 
GET REMOTE FILE'S ATTRIBUTES AND SIZE 


Purpose: Determine the current attribute bits for the given file on the network or installable file system drive, 


Available on: DOS 3.1 or higher, 


Registers at call: 
AX = 110Fh 
SS = DOS DS 


SDA first filename pointer -> fully-qualified name 
of file 
SDA CDS pointer -> current directory structure for 
drive with file 
Details: This function is called by the DOS 3.1+ kernel. 
Conflicts: None known, 


Restrictions: Network redirector or IFS driver must be 
installed. 
Return Registers: 
CF set on error 
AX = DOS error code (see INT 21h Function 59h, 
chapter 8) 
CF clear if successful 
AX = file attributes 
BX:DI = file size 
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See Also: Function 11h Subfunction OEh, INT 21h Function 43h Subfunction 00h (chapter 8), INT 21h Function 60h 


(chapter 8) 


INTERRUPT 2Fh - Function 11h, Subfunction 10h 
Unknown Function 

Purpose: unknown. 

Available on: DOS 4.x only. 

Registers at call: 

AX = 1110h 

SDA first filename pointer -> name of file 

other unknown. 


Restrictions: IFSFUNC.EXE must be installed, 
Return Registers: unknown. 


Details: This call appears to be similar to Function 11h Subfunction OEh. 


Conflicts: None known. 
See Also: Function 11h Subfunction OEh 


INTERRUPT 2Fh - Function 11h, Subfunction 11h 
RENAME REMOTE FILE 


Purpose: Change the name of the specified file to the given new name. 


Available on: DOS 3.1 or higher. 


Registers at call: 

AX=111Ih 

SS = DS = DOS DS 

SDA first filename pointer = offset of fully- 
qualified old name 

SDA second filename pointer = offset of fully- 
qualified new name 

SDA CDS pointer -> current directory structure for 
drive with file 

Details: This function is called by the DOS 3.1+ kernel. 

Conflicts: None known. 

See Also: INT 21h Functions 56h and 60h (chapter 8) 


INTERRUPT 2Fh - Function 11h, Subfunction 12h 
Unknown Function 


Purpose: wknown. 

Available on: DOS 4.x only. 

Registers at call: 

AX = 1112h 

SS = DS = DOS DS 

SDA first filename pointer -> name of file 

other unknown, 

Conflicts: None known. 

See Also: Function 11h Subfunction 11h (chapter 19) 


INTERRUPT 2Fh - Function 11h, Subfunction 13h 
DELETE REMOTE FILE 


Restrictions: Network redirector or IFS driver must be 
installed. 
Return Registers: 
CF set on error 
AX = DOS error code (see INT 21h Function 59h, 
chapter 8) 
CF clear if successful 


Restrictions: IFSFUNC.EXE must be installed. 
Return Registers: unknown. 


Purpose: Erase the indicated file on the network or installable file system drive, 


Available on: DOS 3.1 or higher. 


Registers at call: 
AX = 1113h 


Restrictions: Network redirector or IFS driver must be 
installed. 

Return Registers: 

CF set on error 
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SS = DS = DOS DS AX = DOS error code (see INT 21h Function 59h, 
SDA first filename pointer -> fully-qualified chapter 8) 
filename in DOS DS CF clear if successful 


SDA CDS pointer -> current directory structure for 
drive with file 
Details: This function is called by the DOS 3.1+ kernel. The filespec may contain wildcards. 
Conflicts: None known. 
See Also: INT 21h Functions 41h and 60h (chapter 8) 


INTERRUPT 2Fh - Function 11h, Subfunction 14h 


Unknown Function 

Purpose: unknown. 

Available on: DOS 4.x only. Restrictions: IFSFUNC.EXE must be installed. 
Registers at call: Return Registers: unknown. 

AX = 1114h 


SDA first filename pointer -> name of file 

other unknown, 

Conflicts: None known. 

See Also: Function 11h Subfunction 13h (chapter 19) 


INTERRUPT 2Fh - Function 11h, Subfunction 15h 


Unknown Function 


Purpose: unknown. 

Available on: DOS 4.x only. Restrictions: IFSFUNC.EXE must be installed. 
Registers at call: Return Registers: unknown. 

AX=1115h 

SS = DOS DS 

ES:DI -> SFT 

other unknown. 

Conflicts: None known. 

See Also: Function 11h Subfunction 2Eh 


INTERRUPT 2Fh - Function 11h, Subfunction 16h 
OPEN EXISTING REMOTE FILE 


Purpose: Prepare for operations on the specified file on the network or installable file system drive. 


Available on: DOS 3.1 or higher. Restrictions: Network redirector or IFS driver must be 
installed. 
Registers at call: Return Registers: 
AX = 1116h CF set on error 
ES:DI -> uninitialized SFT AX = DOS error code (see INT 21h Function 59h, 
SS = DOS DS chapter 8) 
SDA first filename pointer -> fully-qualified name CF clear if successful 
of file to open SFT filled (except handle count, which DOS 
STACK: WORD file open mode (see INT 21h manages itself) 
Function 3Dh, chapter 8) STACK unchanged 


Details: This function is called by the DOS 3.1+ kernel. 
Conflicts: None known. 
See Also: Function 11h Subfunctions 06h, 17h, 18h, and 2Eh, INT 21h Functions 3Dh and 60h (chapter 8) 


INTERRUPT 2Fh - Function 11h, Subfunction 17h 
CREATE/TRUNCATE REMOTE FILE 


Purpose: Create the specified file if it does not already exist, or truncate it to zero bytes if it does exist. 
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Available on: DOS 3.1 or higher. Restrictions: Network redirector or IFS driver must be 
installed. 
Registers at call: Return Registers: 
AX =1117h CF set on error 
ES:DI -> uninitialized SFT AX = DOS error code (see INT 21h Function 59h, 
SS = DOS DS chapter 8) 
SDA first filename pointer -> fully-qualified name CF clear if successful 
of file to open SFT filled (except handle count, which DOS 
SDA CDS pointer -> current directory structure for manages itself) 
drive with file STACK. unchanged 


creation mode 
STACK at call: WORD file 
low byte = file attributes 
high byte = 00h normal create, 01h create 
new file 
Details: This function is called by the DOS 3.1+ kernel. 


Conflicts: None known. 
See Also: Function 11h Subfunctions 06h, 16h, 18h, and 2Eh, INT 21h Functions 3Ch and 60h (chapter 8) 


INTERRUPT 2Fh - Function 11h, Subfunction 18h 
CREATE/TRUNCATE FILE WITHOUT CDS 


Purpose: Create or truncate to zero bytes the specified file on a network or installable file system drive which does 
not have a current directory structure, 


Available on: DOS 3.1 or higher. Restrictions: Network redirector or IFS driver must be 
installed. 
Registers at call: Return Registers: 
AX =1118h unknown. 
ES:DI -> uninitialized SFT STACK unchanged 
SS = DOS DS 
SDA first filename pointer -> fully-qualified name 
of file 


Details: This function is called by the DOS 3.1+ kernel when creating a file on a drive for which the SDA CDS 


pointer has offset FFFFh. 
STACK at call: WORD file creation mode 
low byte = file attributes 
high byte = 00h normal create, 01h create new file 


Conflicts: None known. 
See Also: Function 11h Subfunctions 06h, 16h, 17h, and 2Eh, INT 21h Function 60h (chapter 8) 


INTERRUPT 2Fh - Function 11h, Subtunction 19h 
FINDFIRST WITHOUT CDS 


Parpose: Find the first file matching the given specification on a network or installable file system drive which does 
not have a current directory structure. 


Available on: DOS 3.1 or higher. Restrictions: Network redirector or IFS driver must be 
installed, 

Registers at call: Return Registers: 

AX =1119h CF set on error 

8S =DS =DOS DS AX = DOS error code (see INT 21h Function 59h, 

[DTA] = uninitialized 21-byte findfirst search data chapter 8) 
(see INT 21 Function 4Eh, chapter 8) CF clear if successful 

SDA first filename pointer -> fully-qualified search (DTA] = updated findfirst search data (bit 7 of first 
template byte must be set) 


SDA search attribute = attribute mask for search {[DTA+15h] = standard directory entry for file 
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Details: This function is called by the DOS 3.1+ kernel. DOS 4.0 IFSFUNC returns CF set, AX=0003h. 
Conflicts: None known. 
See Also: Function 11h Subfunction 1Bh 


INTERRUPT 2Fh - Function 11h, Subfunction 1Ah 


Unknown Function 

Purpose: unknown. 

Available on: DOS 4.x only. Restrictions: IFSFUNC.EXE must be installed. 
Registers at call: Return Registers: 

AX = 111Ah CF set 

other unknown. AX = error code (03h for DOS 4.01 IFSFUNC) 


Conflicts: None known, 
INTERRUPT 2Fh - Function 11h, Subfunction 1Bh 
FINDFIRST 


Purpose: Find the first file matching the indicated specification in the specified directory on the network or 
installable file system drive. 


Available on: DOS 3.1 or higher. Restrictions: Network redirector or IFS driver must be 
installed. 

Registers at call: Return Registers: 

AX = 111Bh CF set on error 

SS = DS = DOS DS AX = DOS error code (see INT 21h Function 59h, 

[DTA] = uninitialized 21-byte findfirst search data chapter 8) 
(see INT 21 Function 4Eh, chapter 8) CF clear if successful 

SDA first filename pointer -> fully-qualified search [DTA] = updated findfirst search data (bit 7 of first 
template byte must be set) 

SDA CDS pointer -> current directory structure for [DTA+15h] = standard directory entry for file 


drive with file 
SDA search attribute = attribute mask for search 
Details: This function is called by the DOS 3.1+ kernel. 
Conflicts: None known. 
See Also: Function 11h Subfunctions 19h and 1Ch, INT 21h Functions 4Eh and 60h (chapter 8) 


INTERRUPT 2Fh - Function 11h, Subfunction 1Ch 


FINDNEXT 
Purpose: Find subsequent files matching a file specification on the network or installable file system drive. 
Available on: DOS 3.1 or higher. Restrictions: Network redirector or IFS driver must be 
installed. 
Registers at call: Return Registers: 
AX =111Ch CF set on error 
85 = DS = DOS DS AX = DOS error code (see INT 21h Function 59h, 
[DTA] = 21-byte findfirst search data (see INT 21h chapter 8) 
Function 4Eh, chapter 8) CF clear if successful 


[DTA] = updated findfirst search data (bit 7 of first 
byte must be set) 
[DTA+15h] = standard directory entry for file 
Details: This function is called by the DOS 3.1+ kernel. 
Conflicts: None known. 
See Also: Function [1h Subfunction 1Bh, INT 21h Function 4Fh (chapter 8). 


INTERRUPT 2Fh - Function 11h, Subfunction 1Dh 
CLOSE ALL REMOTE FILES FOR PROCESS 


Purpose: Close all files owned by the calling process which were opened using FCBs. 





i 
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Available on: DOS 3.1 or higher. 


Registers at call: 
AX= 111Dh 

DS unknown. 

SS = DOS DS 


Details: This function is called by the DOS 3.1+ kernel. 


Conflicts: None known. 


INTERRUPT 2Fh - Function 11h, Subfunction 1Eh 


DO REDIRECTION 


Purpose: Control the redirector. 
Available on: DOS 3.1 or higher. 


Registers at call: 

AX = L11Eh 

SS = DOS DS 

WORD on top of STACK is function to execute: 


5FOOh get redirection mode 
BL = type (03h printer, 04h disk) 
S5FOth set redirection mode 
BL = type (03h printer, 04h disk) 
BH = state (00h off, 01h on) 
5F02h get redirection list entry 
BX = redirection list index 
DS:SI -> 16-byte local device name buffer 
ES:DI -> 128-byte network name buffer 
5F03h redirect device 
BL = device type (see INT 21h Function 
5Fh Subfunction 03h, chapter 8) 
CX = stored parameter value 
DS:SI -> ASCIZ source device name 
ES:DI -> destination ASCIZ network path + 
ASCIZ passwd 
5F04h cancel redirection 
DS:SI -> ASCIZ device name or network 
path 
SFOS5h get redirection list extended entry 
BX = redirection list index 
DS:SI -> buffer for ASCIZ source device 
name 
ES:DI -> buffer for destination ASCIZ 
network path 
S5F06h apparently similar to SFOSh 


Details: This function is called by the DOS 3.1+ kernel. 


Conflicts: None known. 


Restrictions: Network redirector or IFS driver must be 


installed. 


Return Registers: unknown. 


Restrictions: Network redirector or IFS driver must be 
installed. 
Return Registers: 
CF set on error 
AX = error code (see INT 21h Function 59h, 
chapter 8) 
STACK unchanged 
BH = state (00h off, 01h on) 


BH = status flag 

BL = type (03h printer, 04h disk) 

CX = stored parameter value 

BP = NETBIOS local session number 


See Also: INT 21h Function 5Fh Subfunctions 00h through 06h (chapter 8) 


INTERRUPT 2Fh - Function 11h, Subfunction 1Fh 


PRINTER SETUP 


Purpose: Get or set the printer mode or the printer setup string. 
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Available on: DOS 3.1 or higher. Restrictions: Network redirector or IFS driver must be 
installed. 
Registers at call: Return Registers: 
AX=111Fh CF set on error 
STACK: WORD function AX = error code (see INT 21h Function 59h, 
5E02h set printer setup chapter 8) 
5E03h get printer setup STACK unchanged 


SE04h set printer mode 
SE05h get printer mode 
Details: This function is called by the DOS 3.1+ kernel. 
Conflicts: None known. 
See Also: INT 21h Function SEh Subfunctions 02h through 05h (chapter 8) 


INTERRUPT 2Fh - Function 11h, Subfunction 20h 


FLUSH ALL DISK BUFFERS 

Purpose: Force all pending writes to be performed immediately. 

Available on: DOS 3.1 or higher. Restrictions: Network redirector or IFS driver must be 
installed. 

Registers at call: Return Registers: 

AX = 1120h CF clear (successful) 

DS = DOS DS 

unknown. 


Details: This function is called by the DOS 3.1+ kernel; it uses the CDS array pointer and LASTDRIVE= entries in 
the DOS list of lists. 

Conflicts: None known. 

See Also: INT 21h Function ODh (chapter 8), INT 21h Function 5Dh Subfunction 01h (chapter 8) 


INTERRUPT 2Fh - Function 11h, Subfunction 21h 
SEEK FROM END OF REMOTE FILE 


Purpose: Set the file pointer to the specified offset from the current end of the given file, 


Available on: DOS 3.1 or higher. Restrictions: Network redirector or IFS driver must be 
installed. 

Registers at call: Return Registers: 

AX = 1121h CF set on error 

CX:DX = offset (in bytes) from end AL = DOS error code (see INT 21h Function 59h, 

ES:DI -> SFT chapter 8) 

SFT DPB field -> DPB of drive with file CF clear if successful 

SS = DOS DS DX:AX = new file position 


Details: This function is called by the DOS 3.1+ kernel. 
Conflicts: None known. 
See Also: Function 12h Subfunction 28h, INT 21h Function 42h (chapter 8) 


INTERRUPT 2Fh - Function 11h, Subfunction 22h 
PROCESS TERMINATION HOOK 


Purpose: Perform any necessary cleanup when a program exits. 


Available on: DOS 3.1 or higher. Restrictions: Network redirector or IFS driver must be 
installed. 

Registers at call: Return Registers: unknown. 

AX = 1122h 

SS = DOS DS 

unknown, 


Details: This function is called by the DOS 3.1+ kernel. 
Conflicts: None known. 


Network Redirector and CD-ROM Extensions 19-13 


INTERRUPT 2Fh - Function 11h, Subfunction 23h 
QUALIFY REMOTE FILENAME 


Purpose: Determine the canonical name for the specified file. 


Available on: DOS 3.1 or higher. Restrictions: Network redirector or IFS driver must be 
installed, 

Registers at call: Return Registers: 

AX = 1123h CF set if not resolved 


DS:SI -> ASCIZ filename to canonicalize 

ES:DI -> 128-byte buffer for qualified name 

Details: This function is called first by the DOS 3.1+ kernel when DOS attempts to resolve a filename (unless inside 
a Function 5Dh Subfunction 00h server call); if this fails, DOS resolves the name locally. 

Conflicts: None known. 

See Also: Function 12h Subfunction 21h, INT 21h Function 60h (chapter 8) 


INTERRUPT 2Fh - Function 11h, Subfunction 24h 

CANCEL PRINT ECHOING 

Purpose: Tell the redirector to disable print echoing. 

Available on: DOS 3.1 or higher. Restrictions: Network redirector or IFS driver must be 
installed, 

Registers at call: Return Registers: 

AX = 1124h CX = unknown. 

ES:DI -> SFT 

SS = DOS DS 

unknown. 

Details: This function is called by the DOS 3.1+ kernel if Subfunction 26h returns with CF set. 

Conflicts: None known. 

See Also: Function 11h Subfunction 26h 


INTERRUPT 2Fh - Function 11h, Subfunction 25h 
REDIRECTED PRINTER MODE 


Purpose: Specify or determine whether redirected printer output is combined into a single job, or start a new job 


immediately, 
Available on: DOS 3.1 or higher. Restrictions: Network redirector or IFS driver must be 
installed. 
Registers at call: Return Registers: 
AX = 1125h CF set on error 
AX = error code 
(see INT 2th Function 59h, chapter 8) 
STACK: WORD subfunction STACK unchanged 
5DO07h get print stream state DL = current state 


5D08h set print stream state 
DL = new state 
5D09h finish print job 
Details: This function is called by the DOS 3.1+ kernel. 
Conflicts: None known. 
See Also: DOS INT 21h Function 5Dh Subfunctions 07h, 08h, and 09h 


INTERRUPT 2Fh - Function 11h, Subfunction 26h 


TOGGLE PRINT ECHOING 
Purpose: Indicate to the redirector that the printer echo of console output has been toggled, 
Available on: DOS 3.1 or higher. Restrictions: Network redirector or IFS driver must be 


installed. 
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Registers at call: 
AX = 1126h 
unknown, 


Return Registers: 
CF set on error 


Details: This function is called by the DOS 3.1+ kernel when print echoing (AP, “PrtSc) changes state. 


Conflicts: None known, 
See Also: Function 11h Subfunction 24h 


INTERRUPT 2Fh - Function 11h, Subfunctions 27h through 29h 


UNUSED 


Purpose: None. 

Available on: DOS 4.x only. 
Registers at call: 

AX = 1127h through 1129h 


Conflicts: None known. 


INTERRUPT 2Fh - Function 11h, Subfunction 2Ah 


Unknown Function 


Purpose: Perform an unknown action on each IFS driver. 
Available on: DOS 4.x only. 

Registers at call: 

AX = 112Ah 

DS = DOS DS 

other unknown. 

Conflicts; None known, 


INTERRUPT 2Fh - Function 11h, Subfunction 2Bh 
GENERIC {OCTL 


Purpose: Perform an IOCTL operation on a network drive. 

Available on: DOS 4.x only. 

Registers at call: 

AX = 112Bh 

SS = DOS DS 

CX = function/category 

DS:DX -> parameter block 

STACK: WORD value of AX on entry to INT 21h 
Function 44h (Subfunctions 0Ch or ODh) 

other inputs, if any, unknown. 

Details: This function is called by the DOS 4.0 kemel. 

Conflicts: None known. 


INTERRUPT 2Fh - Function 11h, Subfunction 2Ch 
Unknown Function 

Purpose: unknown. 

Available on: DOS 4.x only. 

Registers at call: 

AX =112Ch 

SS = DOS DS 

SDA current SFT pointer -> SFT for file 

other inputs, if any, unknown. 

Conflicts: None known. 


Restrictions: IFSFUNC.EXE must be installed. 
Return Registers: 
CF set 
AX = 0001h (invalid function) (see INT 21h 
Function 59h, chapter 8) 


Restrictions: JIFSFUNC.EXE must be installed. 
Return Registers: unknown. 


Restrictions: IFSFUNC.EXE must be installed, 
Return Registers: 
CF set on error 
AX = DOS error code 
(see INT 21h Function 59h, chapter 8) 
CF clear if successful 


Restrictions: IFSFUNC.EXE must be installed. 
Return Registers: 
CF set on error 
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INTERRUPT 2Fh - Function 11h, Subfunction 2Dh 


Unknown Function 
Purpose: unknown. 
Available on: DOS 4.x only. Restrictions: IFSFUNC.EXE must be installed. 
Registers at call: Return Registers: 
AX = 112Dh DS = DOS DS 
BL = subfunction (value of AL on INT 21h) CF clear 
04h unknown. 
else unknown. CX = unknown. (00h or 02h for DOS 4.01) 
ES:DI -> SFT 
SS = DOS DS 


Details: This function is called by the DOS 4.0 kernel on INT 21h Function 57h Subfunctions 02h through 04h. 
Conflicts: None known. 


INTERRUPT 2Fh - Function 11h, Subfunction 2Eh 
EXTENDED OPEN/CREATE FILE 


Purpose: Same as INT 21h Function 6Ch for IFS. 


Available on: DOS 4.0 or higher. Restrictions: Network redirector or IFSFUNC.EXE 
must be installed, 
Registers at call: Return Registers: 
AX = 112Eh CF set on error 
SS = DS = DOS DS AX = error code 
ES:DI -> uninitialized SFT for file CF clear if successful 
STACK: WORD file attribute for created/truncated CX = result code: 
file: Olh file opened 
low byte = file attributes 02h file created 
high byte = 00h normal create/open, 03h file replaced (truncated) 
Oth create new file SFT initialized (except handle count, which DOS 
SDA first filename pointer -> fully-qualified manages itself) 
filename 


SDA extended file open action -> action code (see 
INT 21h Function 6Ch Subfunction 00h) 


SDA extended file open mode -> open mode for file 
(see INT 21h Function 6Ch Subfunction 00h) 
Details: This function is called by the DOS 4.0 kernel. 
Conflicts: None known. 
See Also: Function 11h Subfunction 15h, Function 11h Subfunction 16h, Function 11h Subfunction 17h, INT 21h 
Function 6Ch Subfunction 00h 


INTERRUPT 2Fh - Function 11h, Subfunction 2Fh 


Unknown Function 

Purpose: unknown. 

Available on: DOS 4.x only. Restrictions: IFSFUNC.EXE must be installed. 
Registers at call: Return Registers: 

AX = 112Fh CF set on error 

SS = DOS DS AX = DOS error code (see INT 21h Function 59h, 


STACK: WORD function in low byte chapter 8) 
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00h unknown. CF clear if successful 
DS:SI -> Current Directory Structure 
CL = drive (1=A:) 
01h unknown. 
DS:SI -> unknown. 
CL = file handle 
02h unknown. 
DS:SI -> Current Directory Structure 
DI = unknown. 
CX = drive ([=A:) 
other unknown. 
Details: This function is calied by the DOS 4.0 kernel. 
Conflicts: None known. 
See Also: INT 21h Function 6Bh (chapter 8) 


INTERRUPT 2Fh - Function 11h, Subfunction 30h 


GET IFSFUNC SEGMENT 

Purpose: Locate IFSFUNC routine. 

Available on: DOS 4.x only. Restrictions: IFSFUNC.EXE must be installed. 
Registers at call: Return Registers: 

AX = 1130h ES =CS of resident IFSFUNC 


Conflicts: None known. 


INTERRUPT 2Fh - Function 15h, Subfunction 00h 


INSTALLATION CHECK 

Purpose: Determine whether the CDROM extensions are installed, and how many drives are CDROMs. 
Available on: All machines. Restrictions: none. 

Registers at call: Return Registers: 

AX = 1500h BX = number of CDROM drive letters used 
BX = 0000h CX = starting drive letter (O=A:) 


Details: This installation check DOES NOT follow the format used by other software. It conflicts with the DOS 4,00 
GRAPHICS.COM installation check. 
Conflicts: DOS 4.00 GRAPHICS.COM (chapter 8). 


INTERRUPT 2Fh - Function 15h, Subfunction 0th 


GET DRIVE DEVICE LIST 

Purpose: Determine which logical drives are controlled by which device drivers. 

Available on: All machines. Restrictions: CDROM extensions must be installed. 
Registers at call: Return Registers: 

AX = 1501h buffer filled, for each drive letter 


ES:BX -> buffer to hold drive letter list (5 bytes per 
drive letter, see Table 19-1) 
Conflicts: DOS 4.00 GRAPHICS.COM (chapter 8). 


Table 19-1. Format of Buffer layout: 
Offset Size Description 


00h BYTE subunit number in driver 
Olh DWORD _ address of device driver header 


INTERRUPT 2Fh - Function 15h, Subfunction 02h 
GET COPYRIGHT FILE NAME 


Purpose: Determine the name of the file in the CDROM's volume table of contents containing the copyright notice. 
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Available on: All machines. Restrictions: CDROM extensions must be installed. 
Registers at call: Return Registers: 

AX = 1502h CF set if drive is not a CDROM drive 

ES:BX -> 38-byte buffer for name of copyright file AX = 15 (invalid drive) 

CX = drive number (0=A:) CF clear if successful 


Conflicts: DOS 4.00 GRAPHICS.COM (chapter 8). 
See Also: Function 15h Subfunction 03h 


INTERRUPT 2Fh - Function 15h, Subfunction 03h 


GET ABSTRACT FILE NAME 

Purpose: Determine the name of the file in the CDROM's volume table of contents which contains the abstract 
describing the disk. 

Available on: All machines. Restrictions: CDROM extensions must be installed. 
Registers at call: Return Registers: 

AX = 1503h CF set if drive is not a CDROM drive 

ES:BX -> 38-byte buffer for name of abstract file AX = 15 (invalid drive) 

CX = drive number (0=A:) CF clear if successful 


Conflicts: DOS 4.00 GRAPHICS.COM (chapter 8). 
See Also: Function 15h Subfunction 02h 


INTERRUPT 2Fh - Function 15h, Subfunction 04h 
GET BIBLIOGRAPHIC DOC FILE NAME 


Purpose: Determine the name of the file on the CDROM which contains the bibliography. 


Available on: All machines. Restrictions: CDROM extensions must be installed. 
Registers at call: Return Registers: 
AX = 1504h CF set if drive is not a CDROM drive 
ES:BX -> 38-byte buffer for name of bibliographic AX = 15 (invalid drive) 
documentation file CF clear if successful 


CX = drive number (0=A:) 
Conflicts: DOS 4,00 GRAPHICS.COM (chapter 8). 


INTERRUPT 2Fh - Function 15h, Subfunction 05h 


READ VTOC 

Purpose: Retrieve the CDROM's volume table of contents to scan the volume descriptors on the disk. 

Available on: All machines. Restrictions: CDROM extensions must be installed. 

Registers at call: Return Registers: 

AX = 1505h CF set on error 

ES:BX -> 2048-byte buffer AX = error code (15=invalid drive, 21=not ready) 

CX = drive number (0=A:) CF clear if successful 

DX = sector index (0=first volume descriptor, AX = volume descriptor type (1=standard, 
l=second....) FFh=terminator, 0=other) 


Conflicts: DOS 4.00 GRAPHICS.COM (chapter 8). 
INTERRUPT 2Fh - Function 15h, Subfunction 06h 


TURN DEBUGGING ON 

Purpose: Enable debugging during development; only available in development versions. 

Available on: All machines. Restrictions; CDROM extensions must be installed, 
Registers at call: Return Registers: n/a 

AX = 1506h 


BX = debugging function to enable 
Conflicts: DOS 4.00 GRAPHICS.COM (chapter 8). 
See Also: Function 15h Subfunction 07h 
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INTERRUPT 2Fh - Function 15h, Subfunction 07h 


TURN DEBUGGING OFF 

Purpose: Disable debugging; only available in development versions, 

Available on: All machines, Restrictions: CDROM extensions must be installed. 
Registers at call: Return Registers: n/a 

AX = 1507h 


BX = debugging function to disable 
Conflicts: DOS 4.00 GRAPHICS.COM (chapter 8). 
See Also: Function 15h Subfunction 06h 


INTERRUPT 2Fh - Function 15h, Subfunction 08h 


ABSOLUTE DISK READ 

Purpose: Retrieve one or more sectors from the CDROM by physical sector number. 

Available on: All machines. Restrictions: CDROM extensions must be installed. 
Registers at call: Return Registers: 

AX = 1508h CF set on error 

ES:BX -> buffer AL = error code (15=invalid drive, 21=not ready) 
CX = drive number (O=A:) CF clear if successful 


SEDI = starting sector number 

DX = number of sectors to read 

Conflicts: DOS 4.00 GRAPHICS.COM (chapter 8). 
See Also: Function 15h Subfunction 09h 


INTERRUPT 2Fh - Function 15h, Subfunction 09h 


ABSOLUTE DISK WRITE 

Purpose: Reserved for storing sectors on an erasable CDROM authoring system by physical sector number, 
Available on: All machines. Restrictions; CDROM extensions must be installed. 
Registers at call: Return Registers: 

AX = 1509h unspecified 


ES:BX -> buffer 

CX = drive number (0=A:) 

SI:DI = starting sector number 

DX = number of sectors to write 

Details: This call corresponds to INT 26h and is currently reserved and nonfunctional. 
Conflicts: DOS 4.00 GRAPHICS.COM (chapter 8). 

See Also: Function 15h Subfunction 08h 


INTERRUPT 2Fh - Function 15h, Subfunction OAh 


RESERVED 

Purpose: This function is reserved and should not be called. 

Available on: All machines. Restrictions: CDROM extensions must be installed. 
Registers at call: Return Registers: n/a 

AX = 150Ah 


Conflicts: DOS 4.00 GRAPHICS.COM (chapter 8). 
INTERRUPT 2Fh - Function 15h, Subfunction OBh 


DRIVE CHECK 
Purpose: Determine whether or not a drive letter is am MSCDEX CDROM drive. 
Available on: All machines. Restrictions: CDROM extensions version 2.00 or 


higher must be installed. 
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Registers at call: Return Registers: 
AX = 150Bh BX = ADADh if MSCDEX.EXE installed 
CX = drive number (0=A:) AX = 0000h if drive not supported 


nonzero if supported 
Conflicts: DOS 4,00 GRAPHICS.COM (chapter 8). 
See Also: Function 15h Subfunction ODh 


INTERRUPT 2Fh - Function 15h, Subfunction 0Ch 


GET MSCDEX.EXE VERSION 

Purpose: Determine which version of MSCDEX is loaded. 

Available on: All machines. Restrictions: Only valid if CDROM _ extensions 
version 2,00 or higher is installed. 

Registers at call: Return Registers: 

AX = 150Ch BH = major version 


BL = minor version 
Details: MSCDEX.EXE versions prior to 2.00 return BX=0000h. 
Conflicts: DOS 4.00 GRAPHICS.COM (chapter 8). 


INTERRUPT 2Fh - Function 15h, Subfunction ODh 


GET CDROM DRIVE LETTERS 

Purpose: Determine which logical drives correspond to CDROM drives. 

Available on: All machines. Restrictions; CDROM extensions version 2.00 or 
higher must be installed. 

Registers at call: Return Registers: 

AX = 150Dh buffer filled with drive numbers (O=A:). 

ES:BX -> buffer for drive letter list (1 byte per 

drive) 


Details: Bach byte corresponds to the drive in the same position as for function subfunction O1h. 
Conflicts: DOS 4,00 GRAPHICS,COM (chapter 8). 
See Also: Function 15h Subfunction OBh 


INTERRUPT 2Fh - Function 15h, Subfunction 0Eh 

GET/SET VOLUME DESCRIPTOR PREFERENCE 

Purpose: Control whether MSCDEX scans for the primary or secondary volume descriptor when initializing a 
CDROM. 


Available on: All machines. Restrictions: CDROM extensions version 2,00 or 
higher must be installed. 

Registers at call: Return Registers: 

AX = 150Eh CF set on error 


AX = error code 
(15=invalid drive, 1=invalid function) 
CF clear if successful 
BX = subfunction 
00h get preference DX = preference settings 
DX = 0000h 
Oth set preference 
DH = volume descriptor preference 
O1h = primary volume descriptor 
02h = supplementary volume descriptor 
DL = supplementary volume descriptor 
preference 
Olh = shift-Kanji 
CX = drive number (0=A:) 
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Conflicts: DOS 4.00 GRAPHICS.COM (chapter 8). 
INTERRUPT 2Fh - Function 15h, Subfunction OFh 


GET DIRECTORY ENTRY 

Purpose: Retrieve the directory entry for a file on the CDROM. 

Available on: All machines. Restrictions; CDROM extensions version 2.00 or 
higher must be installed. 

Registers at call: Return Registers: 

AX = 150Fh CF set on error 

CL = drive number (0=A:) AX = error code 

CH bit 0 = copy type (0 = direct, 1 = canonicalize) CF clear if succesful 

ES:BX -> ASCIZ path name AX = disk format (O=High Sierra, l=ISO 9660) 

SI:DI -> 255- 


byte/285-byte buffer for directory entry 
(Tables 19-2 and 19-3) 
Conflicts; DOS 4.00 GRAPHICS.COM (chapter 8). 


Table 19-2. Format of Directory Entry: 


Offset Size Description 

00h BYTE length of directory entry 

Olh BYTE length of XAR in Logical Block Numbers 
02h DWORD _LBN of data, Intel (little-endian) format 
06h DWORD _LBN of data, Motorola (big-endian) format 
OAh DWORD length of file, Intel format 

OEh DWORD length of file, Motorola format 

---High Sierra 

12h 6BYTEs date and time 

18h BYTE bit flags 

19h BYTE reserved 

--18O 9660 

12h 7BYTEs date and time 

19h BYTE bit flags 

---both formats 

1Ah BYTE interleave size 

1Bh BYTE interleave skip factor 

1Ch WORD volume set sequence number, Intel format 
JEh WORD volume set sequence number, Motorola format 
20h BYTE length of file name 

21h NBYTEs _ file name 


BYTE (optional) padding if filename is odd length 
NBYTEs system data 


Table 19-3. Format of Canonicalized Directory Entry: 


Offset Size Description 

00h BYTE length of XAR in Logical Block Numbers 
Oth DWORD Logical Block Number of file start 

OSh WORD size of disk in logical blocks 

07h DWORD file length in bytes 

OBh 7BYTEs date and time 

12h BYTE bit flags 

13h BYTE interleave size 

14h BYTE interleave skip factor 

15h WORD volume set sequence number 


17h BYTE length of file name 
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18h 38 BYTEs ASCIZ filename 


Table 19-3, Format of Canonicalized Directory Entry (continued) 


Offset Size Description 

3Eh WORD file version number 

40h BYTE number of bytes of system use data 
4ih 220 bytes system use data 


INTERRUPT 2Fh - Function 15h, Subfunction 10h 
SEND DEVICE DRIVER REQUEST 


Purpose: Communicate with CDROM device drivers. 


Available on: All machines. Restrictions: CDROM extensions version 2.10 or 
higher must be installed. 

Registers at call: Return Registers: n/a 

AX= 1510h 


CX = CD-ROM drive letter (0 = A, 1 =B, etc) 

ES:BX -> CD-ROM device driver request header 
(see Function 08h Subfunction 02h, chapter 8) 

Conflicts: DOS 4.00 GRAPHICS.COM (chapter 8). 


INTERRUPT 2Fh - Function B9h, Subfunction 00h 
PC Network RECEIVER.COM - INSTALLATION CHECK 


Purpose: Determine whether RECEIVER.COM is installed. 


Available on: All machines. Restrictions: none. 

Registers at call: Return Registers: 

AX = B900h AL = 00h if not installed 
FFh if installed 


Conflicts: None known. 


INTERRUPT 2Fh - Function B9h, Subfunction 01h 
GET RECEIVER.COM INT 2Fh HANDLER ADDRESS 


Purpose: Determine RECEIVER.COM entry point. 


Available on: All machines. Restrictions: PC Network RECEIVER.COM must be 
installed. 

Registers at call: Return Registers: 

AX = B901h AL = unknown. 


ES:BX -> RECEIVER.COM INT 2Fh handler 
Details: This function allows more efficient execution by letting the caller bypass any other INT 2Fh handlers which 
have been added since RECEIVER.COM was installed. 
Conflicts: None known. 


INTERRUPT 2Fh - Function B9h, Subfunction 03h 
GET RECEIVER.COM POST ADDRESS 


Purpose: Determine address RECEIVER.COM calls on network events, 


Available on; All machines. Restrictions: PC Network RECEIVER.COM must be 
installed. 

Registers at call: Return Registers: 

AX = B903h ES:BX -> POST handler 


Conflicts: None known. 7 
See Also: Function B8h Subfunction 03h, Function B9h Subfunction 04h 
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INTERRUPT 2Fh - Function B9h, Subfunction 04h 
SET RECEIVER.COM POST ADDRESS 


Purpose: Specify which routine RECEIVER.COM invokes on network events. 


Available on: All machines. Restrictions; PC Network RECEIVER.COM must be 
installed. 

Registers at call: Return Registers: n/a 

AX = B904h 


ES:BX -> new POST handler 
Conflicts: None known. 
See Also: Function B8h Subfunction 04h, Function B9h Subfunction 03h 


INTERRUPT 2Fh - Function B9h, Subfunction 05h 


GET FILENAME 

Purpose: Determine the names of files used by the PC Network RECEIVER.COM module. 

Available on: Ali machines, Restrictions: PC Network RECEIVER.COM must be 
installed. 

Registers at call: Return Registers: 

AX = B905h buffers filled from RECEIVER.COM internal buffers 


DS:BX -> 128-byte buffer for filename 1 

DS:DX -> 128-byte buffer for filename 2 

Details: The use of the filenames is unknown, but one appears to be for storing messages. 
Conflicts: None known. 

See Also: Function B9h Subfunction 06h 


INTERRUPT 2Fh - Function B9h, Subfunction 06h 


SET FILENAME 

Purpose: Specify the names of files used by the PC Network RECEIVER.COM module. 

Available on; All machines. Restrictions: PC Network RECEIVER.COM must be 
installed. 

Registers at call: Return Registers: 

AX = B906h RECEIVER.COM internal buffers filled from user 

DS:BX -> 128-byte buffer for filename 1 buffers 


DS:DX -> 128-byte buffer for filename 2 

Details: The use of the filenames is unknown, but one appears to be for storing messages. 
Conflicts: None known. 

See Also: Function B9h Subfunction 05h 


INTERRUPT 2Fh - Function B9h, Subfunction 08h 
UNLINK KEYBOARD HANDLER 


Purpose: Remove the last keyboard handler loaded before RECEIVER.COM. 


Available on: All machines. Restrictions: PC Network RECEIVER.COM must be 
installed. 
Registers at call: Return Registers: n/a 
AX = B908h 
ES:BX -> INT 09 handler RECEIVER should call 
after it finishes INT 09 


Details: This call replaces the address to which RECEIVER.COM chains on an INT 09h without preserving the 
original value. This allows a prior handler to unlink, but does not allow a new handler to be added such that 
RECEIVER gets the INT 09h first. 

Conflicts: None known. 
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INTERRUPT 2Fh - Function BFh, Subfunction 00h 
internal - INSTALLATION CHECK 


Purpose: Determine whether the PC LAN Program REDIRIFS.EXE module is installed. 


Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AX = BFOOh AL = FFh if installed 


Conflicts: None known. 


INTERRUPT 2Fh - Function BFh, Subfunction 01h 
internal - Unknown Function 


Purpose: unknown. 


Available on: All machines. Restrictions: PC LAN Program REDIRIFS.EXE must 
be installed, 

Registers at call: Return Registers: unknown. 

AX = BFOih 

unknown. 


Conflicts: None known. 


INTERRUPT 2Fh - Function BFh, Subfunction 80h 
internal - SET REDIRIFS ENTRY POINT 


Purpose: Specify a handler which is to be invoked on all future IFS calls to REDIR.SYS. 


Available on: All machines. Restrictions: PC LAN Program REDIR.SYS must be 
installed. 
Registers at call: Return Registers: 
AX = BF80h AL = FFh if installed 
ES:DI -> FAR entry point to IFS handler in ES:DiI -> internal workspace 
REDIRIFS 


Conflicts: None known. 





Chapter m 20 


Novell NetWare 


In the world of network operation, Novell NetWare appears to hold a position similar to that held by MS-DOS with 
respect to operating systems. While NetWare is by no means the only networking system available, it is the accepted 
standard to which all others are compared. 

It should come as no surprise, then, to find that the interrupt functions used by NetWare provide a multitude of ser- 
vices, or that some other networking systems have also adopted certain NetWare interrupt functions. This chapter lists 
the functions used by NetWare, including those calls provided by other networking systems. The functions are listed 
in sequence by interrupt number, function, and subfunction. 

A note about version numbers: NetWare 4.0 and 4.6 are old versions that predate the current Advanced Netware, 
which is commonly called just "NetWare". Thus, functions for "NetWare 4.0 or higher" also apply to Advanced 
NetWare. 





INTERRUPT 21h - Function BSh, Subfunction 03h 


TASK MODE CONTROL 

Purpose: Determine the current value of the task mode byte. 

Available on: All machines. Restrictions: NetWare shell version 3.01 or higher 
must be installed. 

Registers at call: Return Registers: 

AX = B503h AH = 00h 


; AL = current task mode byte (Table 20-1) 

Details: The task mode byte specifies how task cleanup should be performed, but is declared to be version-dependent. 
Conflicts: None known. 

See Also: Function B5h Subfunction 04h. 


Table 20-1. VaLues For Task Mode Byte In Version 3.01: 


Value Meaning 


00h-03h reserved 
04h no task cleanup 


INTERRUPT 21h - Function B5h, Subfunction 04h 
TASK MODE CONTROL 


Purpose: Get a pointer to the task mode byte. 
Available on: All machines. Restrictions: NetWare shell version 3.01 or higher 
must be installed. 
Registers at call: Return Registers: 
AX = B504h ES:BX - >task mode byte 
Details: The task mode byte specifies how task cleanup should be performed, but is declared to be version-dependent. 
The mode byte allows a programs managing task swapping, etc. to disable the automatic cleanup. 
Conflicts: None known, 
See Also: Function B5h Subfunction 03h. 
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INTERRUPT 21h - Function B6h, Subfunctions 00h and 01h 
EXTENDED FILE ATTRIBUTES 


Purpose: Determine or modify the extended attributes for the specified file. 


Available on: All machines. Restrictions: NetWare SFT Level II software must be 
installed. 
Registers at call: Return Registers: 
AH = B6h CF set on error 
AL = subfunction AL = error code 
00h get extended file attributes 8Ch caller lacks privileges 
Olh set extended file attributes FFh file not found 
CL = attributes CL = current extended file attributes 


bits 2-0: search mode (executables only) 
000 none (use shell's default search) 
001 search on all opens without path 
010 do not search 
011 search on read-only opens without path 
100 reserved 
101 search on all opens 
110 reserved 
111 search on all read- only opens 
3: reserved 
4: transaction tracking file 
5: 
6: 





indexing file 
read audit (to be implemented) 
7: write audit (to be implemented) 
DS:DX -> ASCIZ pathname 
Conflicts: None known, 
See Also: DOS Function 43h Subfunction 00h (chapter 8) 


INTERRUPT 21h - Function B8h, Subfunctions 00h thru 09h 


PRINT JOBS 

Purpose: Determine or modify various print spooler options. 

Available on: All machines, Restrictions: Advanced NetWare version 2,0 or higher 
must be installed. 

Registers at call: Return Registers: none 

AH = B8h 


AL = subfunction 
00h get default print job flags 
O1h set default capture flags (Table 20-2) 
02h get specific capture flags 
03h set specific print job flags 
04h get default local printer 
OSh set default local printer 
06h set capture print queue 
O7h set capture print job 
O8h get banner user name 
09h set banner user name 
CX = buffer size 
ES:BX -> buffer 
Conflicts: Attachmate Extra (chapter 26), 
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Table 20-2. Format of Capture Flags Table: 


Offset Size Description 
00h BYTE status (used internally, should be set to 00h) 
Oth BYTE print flags 


bit 2: print capture file if interrupted by loss of connection 
3: no automatic form feed after print job 
6: printing contro] sequences interpreted by print service 
7; print banner page before capture file 





02h BYTE printer number on server 

03h BYTE number of copies to print 

04h BYTE form type required in printer (default 00h) 

05h 13 BYTEs text to be placed on banner page 

12h BYTE reserved 

13h BYTE default local printer (00h = LPT1) 

14h BYTE flush capture file on LPT close if nonzero 

15h WORD timeout in clock ticks for flushing capture file on inactivity (high byte first) 0000h = never 

timeout 

17h WORD maximum lines per page (high byte first) 

19h WORD maximum characters per line (high byte first) 

IBh 13 BYTEs name of form required in printer 

28h BYTE LPT capture flag: 00h inactive, FFh LPT device is being captured 

29h BYTE file capture flag: 00h if no file specified, FFh if capturing to file 

2Ah BYTE timing out (00h if no timeout in effect, FFh if timeout counter running) 
2Bh WORD offset of printer setup string (high byte first) 

2Dh WORD offset of printer reset string (high byte first) 

2Fh BYTE target connection ID 

30h BYTE capture in progress if FFh 

31h BYTE print job number assigned to capture if FFh 

32h WORD bindery object ID of print queue if previous byte FFh 

34h WORD print job number (high byte first) 
INTERRUPT 21h - Function BBh 
SET END OF JOB STATUS 
Purpose: Specify whether an End of Job call will automatically be made on process termination, 
Available on: All machines. Restrictions: NetWare 4.0 or higher, or Alloy network 

software, must be installed. 
Registers at call: Return Registers: 
AH = BBh AL = old EOI flag 
AL = new EOJ flag 
00h disable EOJs 
otherwise enable EOJs 


Conflicts: None known, 
See Also: Function D6h 


INTERRUPT 21h - Function BCh 
LOG/LOCK PHYSICAL RECORD 


Purpose: Prevent other processes from accessing the specified record, and add the record to the log table. 


Available on: All machines. Restrictions: NetWare 4.6 or higher, or Alloy network 
software, must be installed. 
Registers at call: Return Registers: 
AH=BCh AL = error code 
AL = flags 00h successful 
bit 0: lock as well as log record 96h no dynamic memory for file 


1: non-exclusive lock FEh timed out 
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BX = file handle FFh failed 
CX:DX = offset 

BP = timeout in timer ticks (1/18 sec) 

SEDI = length of region to lock 

Conflicts: None known. 

See Also: Functions BDh and BFh 


INTERRUPT 21h - Function BDh 
RELEASE PHYSICAL RECORD 


Purpose: Unlock the specified record but do not remove it from the log table. 


Available on: All machines. Restrictions: NetWare 4.6 or higher, or Alloy network 
software, must be installed. 

Registers at call: Return Registers: 

AH=BDh AL = error code (see Function BCh) 


BX = file handle 

CX:DX = offset 

Conflicts: None known. 

See Also: Functions BCh, BEh, and COh 


INTERRUPT 21h - Function BEh 


CLEAR PHYSICAL RECORD 

Purpose: Unlock the specified record and remove it from the log table. 

Available on: All machines. Restrictions; NetWare 4.6 or higher, or Alloy network 
software, must be installed. 

Registers at call: Return Registers: 

AH = BEh AL = error code (see Function BCh) 

BX = file handle 

CX:DX = offset 

Conflicts: "Datalock" and "1049" viruses (chapter 34). 

See Also: Functions BCh, BDh, and Clh 

INTERRUPT 21h - Function BFh 

LOG/LOCK RECORD (FCB) 

Purpose: Prevent other processes from accessing the specified record, and add the record to the log table. 

Available on: All machines. Restrictions: NetWare 4.6 or higher, or Alloy network 
software, must be installed. 

Registers at call: Return Registers: 

AH = BFh AL = error code (see Function BCh) 

AL = flags 


bit 0: lock as well as log record 
1: non-exclusive lock 
DS:DX -> opened FCB (see DOS Function OFh, 
chapter 8) 
BX:CX = offset 
BP = lock timeout in timer ticks (1/18 sec) 
SIDI = length 
Conflicts: None known. 
See Also: Functions BCh, COh, and C2h 


INTERRUPT 21h - Function COh 
RELEASE RECORD (FCB) 


Purpose: Unlock the specified record but do not remove it from the log table. 


Novell NetWare 20-5 


Restrictions: NetWare 4.6 or higher, or Alloy network 
software, must be installed. 

Registers at call: Return Registers: 

AH=COh AL = error code (see Function BCh) 

DS:DX -> FCB (see DOS Function OFh, chapter 8) 


BX:CX = offset 
Conflicts: "Slow" virus, "Solano" virus (both in chapter 34). 
See Also: Functions BDh, BFh, Clh, and C3h 


INTERRUPT 21h - Function Cth 

CLEAR RECORD (FCB) 

Purpose: Unlock the specied record and remove it from the log table. 

Available on: All machines. Restrictions: NetWare 4.6 or higher, or Alloy network 
software, must be installed. 


Available on: Ali machines. 


Registers at call: Return Registers: 
AH=Clh AL = error code (see Function BCh) 
DS:DX -> opened FCB (see DOS Function OFh, 

chapter 8) 


BX:CX = offset 
Conflicts: “Solano” virus (chapter 34), 
See Also: Functions BEh, COh, and C4h 


INTERRUPT 21h - Function C2h 
LOCK PHYSICAL RECORD SET 


Purpose: Prevent other processes from accessing the specified records, and add them to the log table. 


Available on: All machines, Restrictions: NetWare 4.6 or higher, or Alloy network 
software, must be installed, 
Registers at call: Return Registers: 
AH = C2h AL = error code 
AL = flags 00h successful 
bit 1: non-exclusive lock FEh timed out 
BP = lock timeout in timer ticks (1/18 sec) FFh failed 


Conflicts: "Scott's Valley" virus (chapter 34). 
See Also: Functions BFh and C3h 


INTERRUPT 21h - Function C3h 
RELEASE PHYSICAL RECORD SET 


Purpose: Unlock the specified records but do not remove any of them from the log table. 


Available on: All machines. Restrictions: NetWare 4.6 or higher, or Alloy network 
software, must be installed. 

Registers at call: Return Registers: 

AH = C3h AL = error code 


Conflicts: "905" virus (chapter 34). 
See Also: Functions COh, C2h, and C4h 


INTERRUPT 21h - Function C4h 
CLEAR PHYSICAL RECORD SET 


Purpose: Both unlock and remove from the log table the specified set of records. 


Available on: All machines. Restrictions: NetWare 4.6 or higher, or Alloy network 
software, must be installed. 

Registers at call: Return Registers: 

AH =C4h AL = error code 


Conflicts: None known. 
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See Also: Function Clh 


INTERRUPT 21h - Function C5h, Subfunctions 00h thru 04h 


SEMAPHORES 


Purpose: Control access to resources which are not shareable or can only be accessed by a limited number of 


processes at once. 
Available on: All machines. 


Registers at call: 
AH = C5h 
AL = subfunction 


00h open semaphore 
DS:DX -> semaphore name (counted string) 
CL = initial value 
O1h examine semaphore 
CX:DX = semaphore handle 
02h wait on semaphore 
CX:DX = semaphore handle 
BP = timeout in timer ticks (1/18 sec) 
(0000h = no wait) 
03h signal semaphore 
CX:DX = semaphore handle 
04h close semaphore 
CX:DX = semaphore handle 
Conflicts: "Sverdlov" virus (chapter 34). 


Restrictions: NetWare 4.6 or higher, or Alloy network 
software, must be installed. 
Return Registers: 
AL = error code 
00h successful 
Oh semaphore value overflow 
96h out of string space on server 
FEh invalid string length (AL=00h) or timeout 
FFh invalid initial value (AL=00h) or invalid 
handle 
CX:DX = semaphore handle 
BL = open count 


CX = semaphore value (sign extended) 
DL = open count 


INTERRUPT 21h - Function C6h, Subfunctions 00h thru 02h 


GET OR SET LOCK MODE 


Purpose: Determine or specify the file locking mode. 


Available on: All machines. 


Registers at call: 
AH =C6h 
AL = subfunction 
00h set old “compatibility” mode 
Olh set new extended locks mode 
02h get lock mode 
Conflicts: "Yankee" or "MLTI" virus (chapter 34), 


Restrictions; NetWare 4.6 or higher, or Alloy network 
software, must be installed. 

Return Registers: 

AL = current lock mode 


INTERRUPT 21h - Function C7h, Subfunctions 00h thru 08h 


TRANSACTION TRACKING SYSTEM 


Purpose: Allow multiple stations to protect their concurrent database updates by permitting the server to back out of 


interrupted transactions. 
Available on: All machines. 
Registers at call: 
AH = C7h 
AL = subfunction 
00h begin transaction (NetWare SFT level II) 


Restrictions: NetWare 4.0 or higher must be installed. 
Return Registers: 
Subfunction 00h: 

AL = error code 


Olh end transaction (NetWare SFT level II) 


02h TTS available (NetWare SFT level If) 


03h abort transaction (NetWare SFT level II) 


04h transaction status 

O5h get application thresholds 

OGh set application thresholds 

O7h get workstation thresholds 

O8h set workstation thresholds 
Conflicts: None known, 


INTERRUPT 21h - Function C8h 
BEGIN LOGICAL FILE LOCKING 


Purpose: Enable file locking. 
Available on: All machines. 
Registers at call: 
AH =C8h 
if function C6h lock mode 00h: 
DL = mode: 00h no wait, 01h wait 
if function C6h lock mode 01h: 
BP = timeout in timer ticks (1/18 sec) 
Conflicts: None known. 
See Also: Function C9h 


INTERRUPT 21h - Function C9h 
END LOGICAL FILE LOCKING 


Purpose: Disable file locking. 
Available on: All machines, 
Registers at call: 

AH=C9h 

Conflicts: None known. 

See Also: Function C8h 


INTERRUPT 21h - Function CAh 
LOG/LOCK PERSONAL FILE (FCB) 
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Subfunction O1h: 
AL = error code 
CX:DX = transaction reference number 
Subfunction 02h: 
AL = completion code 
00h TTS not available 
Oh TTS available 
FDh TTS available but disabled 
Subfunction 03h: 
AL = error code 
others: unknown 


Restrictions: NetWare 4.0 or higher must be installed. 
Return Registers: 
AL = error code 


Restrictions: NetWare 4.0 or higher must be installed. 
Return Registers: 
AL = error code 


Purpose: Prohibit others from accessing the file corresponding to the specified File Control Block. 


Available on: All machines. 


Registers at call: 
AH =CAh 
DS:DX -> FCB (see DOS Function OFh, chapter 8) 
if function C6h lock mode Oth: 
AL = log and lock flag 
00h log file only 
O1h lock as well as log file 
BP = lock timeout in timer ticks (1/18 sec) 
Conflicts: "Piter" virus (chapter 34). 


Restrictions: NetWare 4.0 or higher, or Alloy network 
software, must be installed. 
Return Registers: 
AL = error code 
00h successful 
96h no dynamic memory for file 
FEh timeout 
FFh failed 
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See Also: Function CBh 
INTERRUPT 21h - Function CBh 


LOCK FILE SET 

Purpose: Attempt to place locks on ail logged personal files. 

Available on: All machines. Restrictions: NetWare 4.0 or higher, or Alloy network 
software, must be installed. 

Registers at call: Return Registers: 

AH=CBh AL = error code 

if function C6h lock mode 00h: 00h successful 

DL = mode FEh timed out 
00h no wait FFh failed 
O1h wait 
if function C6h lock mode O1h: 
BP = lock timeout in timer ticks (1/18 sec) 

Conflicts: None known. 

See Also: Function CAh 

INTERRUPT 21h - Function CCh 

RELEASE FILE (FCB) 

Purpose: Unlock the specified file, but do not remove it from the log table or close it. 

Available on: All machines. Restrictions: NetWare 4.0 or higher, or Alloy network 
software, must be installed. 

Registers at call: Return Registers: none 

AH =CCh 

DS:DX -> FCB (see DOS Function OFh, chapter 8) 

Conflicts: Westwood" virus (chapter 34). 

See Also: Functions CAh and CDh 

INTERRUPT 21h - Function CDh 

RELEASE FILE SET 

Purpose: Unlock all personal files, but do not remove any of them from the log table. 

Available on: All machines. Restrictions: NetWare 4.0 or higher, or Alloy network 
software, must be installed, 

Registers at call: Return Registers: none 

AH = CDh | 


Conflicts: "Westwood" virus (chapter 34). 
See Also: Functions CAh and CCh 


INTERRUPT 21h - Function CEh 


CLEAR FILE (FCB) 


Purpose: Unlock the specified file and remove it from the log table, then close all opened and logged occurrences of 
the file. 


Available on: All machines, Restrictions: NetWare 4.0 or higher, or Alloy network 
software, must be installed. 

Registers at call: Return Registers: 

AH =CEh AL = error code 


DS:DX -> FCB (see DOS Function OFh, chapter 8) 
Conflicts: None known. 
See Also: Functions CAh, CFh, and EDh 


| 
: 
: 








| 
| 
| 
| 
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INTERRUPT 21h - Function CFh 


CLEAR FILE SET 

Purpose: Unlock and remove all entries in the personal file log table. 

Available on: All machines. Restrictions: NetWare 4.0 or higher, or Alloy network 
software, must be installed. 

Registers at call: Return Registers: 

AH = CFh AL =00h 

Conflicts: None known. 

See Also: Functions CAh and CEh 

INTERRUPT 21h - Function DOh 

LOCK LOGICAL RECORD 

Purpose: Prevent other processes from accessing the specified record, and add the record to the log table. 

Available on: All machines. Restrictions: NetWare 4.6 or higher, Banyan VINES, 
or Alloy network software must be 
installed, 

Registers at call: Return Registers: 

AH = DOh AL = error code 

DS:DX -> record string (counted string, max 100 00h successful 

data bytes) 96h no dynamic memory for file 
if function C6h lock mode Oth: (Novell, Alloy FEh timed out 
NTNX only) FFh unsuccessful 
AL = flags 
bit 0: lock as well as log the record 
bit [: non-exclusive lock 
BP = lock timeout in timer ticks (1/18 sec) 

Conflicts: "Fellowship" virus (chapter 34). 

See Also: Functions D1h and D2h 

INTERRUPT 21h - Function D1h 

LOCK LOGICAL RECORD SET 

Purpose: Prevent other processes from accessing the specified records, and add them to the log table, 

Available on: All machines. Restrictions: NetWare 4.6 or higher, Banyan VINES, 
or Alloy network software must be 
installed. 

Registers at call: Return Registers: 

AH=DIh AL = error code (see Function DOh) 

if function C6h lock mode 00h: 

DL = mode 
00h no wait 
O1h wait 


if function C6h lock mode O1h: (Novell only) 
BP = lock timeout in timer ticks (1/18 sec) 
0000h no wait 
Conflicts: None known. 
See Also: Functions DOh and D3h 


INTERRUPT 21h - Function D2h 
UNLOCK LOGICAL RECORD 


Purpose: Unlock the specified record but do not remove it from the log table. 
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Available on: All machines. Restrictions: NetWare 4.0 or higher, Banyan VINES, 
or Alloy network software must be 
installed. 

Registers at call: Return Registers: 

AH =D2h AL = error code (see Function D0h) 


DS:DX -> semaphore identifier (counted string up 
to 100 chars long) 

Conflicts: None known, 

See Also: Functions DOh and D3h 


INTERRUPT 21h - Function D3h 
UNLOCK LOGICAL RECORD SET 


Purpose: Unlock all semaphores logged in the requesting PC's semaphore set. 


Available on: All machines. Restrictions: NetWare 4.0 or higher, Banyan VINES, 
or Alloy network software must be 
installed. 

Registers at call: Return Registers: 

AH = D3h AL = error code (see Function D0h) 


Conflicts: None known. 
See Also: Functions D1h and D2h 


INTERRUPT 21h - Function D4h 


CLEAR LOGICAL RECORD 

Purpose: Unlock the specified record and remove it from the log table, 

Available on: All machines. Restrictions: NetWare 4.0 or higher, Banyan VINES, 
or Alloy network software must be 
installed. 

Registers at call: Return Registers: 

AH = D4h AL = error code 

DS:DX -> semaphore identifier (counted string up 00h successful 

to 100 chars long) FFh not successful 


Conflicts: None known. 
See Also: Function D5h 


INTERRUPT 21h - Function D5h 
CLEAR LOGICAL RECORD SET 


Purpose: Unlock and clear all semaphores associated with the requesting PC's semaphore set. 


Available on: All machines. Restrictions: NetWare 4.0 or higher, Banyan VINES, 
or Alloy network software must be 
installed. 

Registers at call: Return Registers: 

AH =D5h AL = error code (see Function D4h) 

Conflicts: "Dir", "Diamond-A", and "Diamond-B" viruses (chapter 34), 

See Also: Function D4h 

INTERRUPT 21h - Function Déh 

END OF JOB 


Purpose: Clean up on program termination by unlocking and clearing all locked or logged files and records held by 

the terminating process, then closing all files, resetting error and lock modes, and releasing all network resources 

held by the process. 

Available on: All machines. Restrictions: NetWare 4.0 or higher, or Alloy network 
software, must be installed. 


Registers at call: 

AH = D6h 

Conflicts: None known. 
See Also: Function BBh 


INTERRUPT 21h - Function D7h 
SYSTEM LOGOUT 

Purpose: Log the user out of the system. 
Available on: All machines. 


Registers at call: 
AH = D7h 
Conflicts: None known. 


INTERRUPT 21h - Function D&8h 
ALLOCATE RESOURCE 

Purpose: Request the use of a specified resource. 
Available on: All machines. 


Registers at call: 
AH =D8h 
DL = resource number 


Conflicts: None known, 
See Also: Function D9h 


INTERRUPT 21h - Function D9h 
DEALLOCATE RESOURCE 


Purpose: Return the specified resource to the system. 


Available on: All machines. 


Registers at call: 

AH = D9h 

DL = resource number 
Conflicts: None known. 
See Also: Function D8h 


INTERRUPT 21h - Function DAh 
GET VOLUME STATISTICS 
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Return Registers: 
AL = error code 


Restrictions: NetWare 4.0 or higher, or Alloy network 
software, must be installed. 

Return Registers: 

AL = error code 


Restrictions; NetWare or Banyan VINES must be 
installed, 
Return Registers: 
AL = status 
00h successful 
FFh unsucessful 


Restrictions: NetWare or Banyan VINES must be 
installed. 

Return Registers: 

AL = status (see Function D8h) 


Purpose: Determine available space on the specified disk volume. 


Available on: All machines. 

Registers at call: 

AH=DAh 

DL = volume number 

ES:DI -> reply buffer (Table 20-3) 
Conflicts: None known. 

See Also; DOS Function 36h (chapter 8) 


Table 20-3. Format of Reply Buffer: 


Offset Size Description 
00h WORD sectors/block 
02h WORD total blocks 


Restrictions: NetWare 4.0 or higher must be installed. 
Return Registers: 
AL = 00h 
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Table 20-3. Format of Reply Buffer (continued) 


Offset Size Description 

04h WORD unused blocks 

06h WORD total directory entries 

08h WORD unused directory entries 

OAh 16BYTEs volume name, null padded 

1Ah WORD removable flag, 0000h = not removable 


INTERRUPT 2ih - Function DBh 
GET NUMBER OF LOCAL DRIVES 


Purpose: Determine how many disk drives are local to the caller's machine. 


Available on: All machines. 


Registers at call: 

AH = DBh 

Conflicts: None known. 

See Also: DOS Function OEh (chapter 8) 


INTERRUPT 21h - Function DCh 
GET STATION NUMBER 


Restrictions: NetWare 4.0 or higher, or Alloy network 
software, must be installed. 

Return Registers: 

AL = number of local disks 


Purpose: Determine the network station number of the caller's machine. 


Available on: All machines. 


Registers at call: 
AH=DCh 


Restrictions: NetWare 4.0 or higher, Banyan VINES, 
or Alloy network software must be 
installed. 

Return Registers: 

AL = station number: 

00h if NetWare not loaded or this machine is a 
non-dedicated server 

CX = station number in ASCII 


Details: The station number is only unique for those PCs connected to the same semaphore service, 
Conflicts: PC Magazine PPMANAGE/DCOMPRES (chapter 36). 


INTERRUPT 21h - Function DDh 
SET ERROR MODE 


Purpose: Control critical error handling. 
Available on: All machines. 


Registers at call: 

AH = DDh 

DL = error mode 
00h invoke INT 24h on critical I/O errors 
Oth return NetWare extended error code in AL 
02h return error code in AL, mapped to standard 

DOS error codes 
Conflicts: None known, 


INTERRUPT 21h - Function DEh 
SET BROADCAST MODE 


Restrictions: NetWare 4.0 or higher, or Alloy network 
software, must be installed. 

Return Registers: 

AL = previous error mode 


Purpose: Specify how incoming broadcast messages are to be handled. 


Available on: All machines. 
Registers at call: 
AH = DEh 


Restrictions: NetWare 4.0 or higher must be installed. 
Return Registers: 
AL = old broadcast mode 
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AL = broadcast mode: 

00h receive console and workstation broadcasts 

Oth receive console broadcasts only 

02h receive no broadcasts 

03h store all broadcasts for retrieval 

04h get broadcast mode 

05h disable shell timer interrupt checks 

06h enable shell timer interrupt checks 
Conflicts: "Durban" virus (chapter 34). 


INTERRUPT 21h - Function DFh, Subfunctions 00h thru 07h 
CAPTURE 
Purpose: Control printer output capturing. 
Available on: All machines. Restrictions: NetWare 4.0 or higher, or Alloy network 
software, must be installed. 
Registers at call: Return Registers: 
AH = DFh AL = error code 
AL = subfunction 
00h start LPT capture 
O1h end LPT capture 
02h cancel LPT capture 
03h flush LPT capture 
04h start specific capture 
05h end specific capture 
OGh cancel specific capture 
07h flush specific capture 
Details: Under NTNX, only Subfunctions 00h-03h are supported, and all four send a print break (see INT 17h 
Function 84h in chapter 18). 
Conflicts: None known. 


INTERRUPT 21h - Function Edh, Subfunctions 00h thru 06h and 09h 


PRINT SPOOLING 

Purpose: Control the print spooler. 

Available on: All machines. Restrictions: NetWare 4.0 or higher, or Alloy network 
software, must be installed, 

Registers at call: Return Registers: 

AH = E0h AL = error code 

DS:SI -> request buffer 

ES:DI -> reply buffer 


subfunction in third byte of request buffer: 

00h spool data to a capture file 

O1h close and queue capture file 

02h set spool flags 

03h spool existing file 

04h get spool queue entry 

05h remove entry from spool queue 

OGh get printer status 

09h create a disk capture file 
Conflicts: OS/286 and OS/386 (chapter 9), DoubleDOS (chapter 17), Jerusalem", "Armagedon" and "8-tunes" 
viruses (chapter 34). 
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INTERRUPT 21h - Function Eth, Subfunctions 00h thru 09h 


BROADCAST MESSAGES 

Purpose: Send or receive messages. 

Available on: All machines. Restrictions: NetWare 4.0 or higher must be installed. 
Registers at call: Return Registers: 

AH=Elh AL = error code 


DS:SI -> request buffer 
ES:DI -> reply buffer 
subfunction in third byte of request buffer: 
00h send broadcast message 
Olh get broadcast message 
02h disable station broadcasts 
03h enable station broadcasts 
04h send personal message 
05h get personal message 
06h open message pipe 
07h close message pipe 
O8h check pipe status 
09h broadcast to console 
Conflicts: OS/286 and OS/386 (chapter 9), DoubleDOS (chapter 17), "Mendoza" and "Fu Manchu" viruses (chapter 
34), 


INTERRUPT 21h - Function E2h, Subfunctions 00h thru 19h 


DIRECTORY FUNCTIONS 

Purpose: Perform manipulations on the specified directory. 

Available on: All machines. Restrictions: NetWare 4.0 or higher, or Alloy network 
software, must be installed. 

Registers at call: Return Registers: 

AH = E2h AL = error code 


DS:SI -> request buffer 
ES:DI -> reply buffer 
subfunction in third byte of request buffer 
00h set directory handle 
Oh get directory path 
02h scan directory information 
03h get effective directory rights 
04h modify maximum rights mask 
OSh get volume number 
O6h get volume name 
OAh create directory 
OBh delete directory 
OCh scan directory for trustees 
ODh add trustee to directory 
OEh delete trustee from directory 
OFh rename directory 
10h purge erased files 
11h restore erased file 
12h allocate permanent directory handle 
13h allocate temporary directory handle 
14h deallocate directory handle 
15h get volume info with handle 
16h allocate special temporary directory handle 


| 
| 
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17h retrieve a short base handle (Advanced 
NetWare 2.0) 
18h restore a short base handle (Advanced 
NetWare 2.0) 
19h set directory information 
Conflicts: 0S/286 and OS/386 (chapter 9), DoubleDOS (chapter 17). 


INTERRUPT 21h - Function ESh 
CONNECTION CONTROL 


Purpose: Establish a new connection or modify an existing one; also provides file and object manipulation 
functions. 


Available on: All machines. Restrictions: NetWare 4.0 or higher, or Alloy network 
software, must be installed, 

Registers at call: Return Registers: 

AH=E3h AL = error code 


DS:SI -> request buffer 
ES:DI -> reply buffer 
subfunction in third byte of request buffer 
(Table 20-4) 
Conflicts: DoubleDOS (chapter 17). 


Table 20-4. Connection Control Subfunctions: 


Value Function 

00h login 

Oth change password 

02h map user to station set 

03h map object to number 

04h map number to object 

O5h get station's logged information 

06h get station's root mask (obsolete) 

07h map group name to number 

O8h map number to group name 

09h get memberset M of group G 

OAh enter login area 

OBh unknown. 

0Ch unknown. 

ODh log network message 

OEh get disk utilization (Advanced NetWare 1.0) 
OFh scan file information (Advanced NetWare 1.0) 
10h set file information (Advanced NetWare 1.0) 
1th get file server information (Advanced NetWare 1.0) 
12h unknown, 

13h get internet address (Advanced NetWare 1.02) 
14h login to file server (Advanced NetWare 2.0) 
15h get object connection numbers (Advanced NetWare 2.0) 
16h get connection information (Advanced NetWare 1.0) 
32h create object (Advanced NetWare 1.0) 

33h delete object (Advanced NetWare 1.0) 

34h rename object (Advanced NetWare 1.0) 

35h get object ID (Advanced NetWare 1.0) 

36h get object name (Advanced NetWare 1.0) 

37h scan object (Advanced NetWare 1.0) 

38h change object security (Advanced NetWare 1.0) 
39h create property (Advanced NetWare 1.0) 

3Ah delete property (Advanced NetWare 1.0) 


3Bh change property security (Advanced NetWare 1.0) 
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Table 20-4. Connection Control Subfunctions (continued) 


Value 
3Ch 
3Dh 


3Eh 
3Fh 
40h 
4th 
42h 
43h 
44h 
45h 
46h 
47h 
C8h 
Co! 
CAh 
CBh 
CC. 
CDh 
CEh 


Dih 
D2h 
D3h 
D4h 
D5h 
D6h 
D7! 
D8h 
D9h 
DAh 
DBh 
DCh 
DDh 
DEh 
DFh 
E0h 
Elh 
E2h 
E3h 
E5h 
E6h 
E7h 
E8h 
E9h 





Function 

scan property (Advanced NetWare 1.0) 

read property value (Advanced NetWare 1.0) 
request buffer contains the property name in all caps 
property "IDENTIFICATION" returns the user's name 

write property value (Advanced NetWare 1.0) 

verify object password (Advanced NetWare 1.0) 

change object password (Advanced NetWare 1.0) 

add object to set (Advanced NetWare 1.0) 

delete object from set (Advanced NetWare 1.0) 

is object in set? (Advanced NetWare 1.0) 

close bindery (Advanced NetWare 1.0) 

open bindery (Advanced NetWare 1.0) 

get bindery access level (Advanced NetWare 1.0) 

scan object trustee paths (Advanced NetWare 1.0) 

check console priviledges 

get file server description strings 

set file server date and time 

disable file server login 

enable file server login 

get file server login status 

purge all erased files 

disable transaction tracking 

enable transaction tracking 

send console broadcast 

clear connection number 

down file server 

get file system statistics 

get transaction tracking statistics 

read disk cache statistics 

get drive mapping table 

read physical disk statistics 

get disk channel statistics 

get connection's task information 

get list of connections open files 

get list of connections using a file 

get physical record locks by connection and file 

get physical record locks by file 

get logical records by connection 

get logical record information 

get connection's semaphores 

get semaphore information 

get LAN driver's configuration information 

get connection's usage statistics 

get object's remaining disk space 

get server LAN I/O statistics 

get server miscellaneous information 

get volume information 


Table 20-5. Format of Object Property: 


Offset 
00h 
N 


N+1 


Size Description 
1-16 BYTEs property name 
BYTE flags: bit 0: propertyis dynamic 


4: property belongs to set rather than item 
BYTE security levels (Table 20-6) 
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Table 20-6. Values for security levels: 


Value Security Level 

00h everyone may access 

Olh only logged-in clients may access 

02h only clients logged-in with object's name, type, and password 
03h only clients logged-in with supervisor privileges 

04h only NetWare may access 


The above values are stored in a nybble; the high half-byte is write access and the low half-byte is read access. 


Table 20-7. Values for object type: 


Value Object Type 

00h unknown 

Olh user 

02h user group 

03h print queue 

04h file server 

05h job server 

06h gateway 

07h print server 

08h archive queue 

09h archive server 

OAh job queue 

OBh administration 

24h remote bridge server 
47h advertising print server 
FFh wild (used only for finding objects) 


INTERRUPT 21h - Function E4h 
SET FILE ATTRIBUTES (FCB) 


Purpose: Specify new file attributes for the file corresponding to the specified file control block. 


Available on: All machines. Restrictions: NetWare 4.0 or higher must be installed. 
Registers at call: : Return Registers: 
AH = B4h AL = error code 


CL = file attributes 
bit 0: read only 
1: hidden 
2: system 
7; shareable 
DX:DX -> FCB (see DOS Function OFh, chapter 8) 
Conflicts; DoubleDOS (chapter 17), "Anarkia" virus (chapter 34), 
See Also: DOS Function 43h Subfunction 01h (chapter 8) 


INTERRUPT 21h - Function ESh 
UPDATE FILE SIZE (FCB) 


Purpose: Force the file size field of the specified File Control Block to reflect the current size of the file, which may 
have been modified by other processes. 


Available on: All machines. Restrictions: NetWare 4.0 or higher must be installed. 
Registers at call: Return Registers: 
AH = E5h AL = error code 


DS:DX -> FCB (see DOS Function OFh, chapter 8) 
Conflicts: DoubleDOS (chapter 17). 





| 
| 
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INTERRUPT 21h - Function E6h 


COPY FILE TO FILE (FCB) 

Purpose: Copy the contents of one file into another, where both files are specified using File Control Blocks. 
Available on: All machines. Restrictions: NetWare 4.0 or higher must be installed. 
Registers at call: Return Registers: 

AH = E6h AL = error code 


CX:DX = number of bytes to copy 
DS:SI -> source FCB 

ES:DI -> destination FCB 
Conflicts: None known. 


INTERRUPT 21h - Function E7h 
GET FILE SERVER DATE AND TIME 


Purpose: Determine the current date and time as known to the network server. 


Available on: All machines. Restrictions: NetWare 4.0 or higher, Banyan VINES, 
or Alloy network software must be 
installed. 

Registers at call: Return Registers: 

AH=E7h AL = error code 

DS:DX -> date/time buffer (Table 20-8) 00h successful 


FFh unsuccessful 
Conflicts: None known. 
See Also: DOS Functions 2Ah and 2Ch (chapter 8) 


Table 20-8. Format of DatelTime Buffer: 


Offset Size Description 

00h BYTE year - 1900 

Olh BYTE month (1=Jan) 

02h BYTE day 

03h BYTE hours 

04h BYTE minutes 

05h BYTE seconds 

06h BYTE day of week (0 = Sunday) (Novell and NTNX only) 

INTERRUPT 21h - Function Eh 

SET FCB RE-OPEN MODE 

Purpose: Specify whether File Control Blocks will be re-opened automatically. 

Available on: All machines. Restrictions: NetWare 4.6 or higher, or Alloy network 
software, must be installed. 

Registers at call: Return Registers: 

AH = E8h AL = error code 

DL = mode 


00h no automatic re-open 
Oth auto re-open 
Conflicts: DoubleDOS (chapter 16). 


INTERRUPT 21h - Function E9h, Subfunction 00h 
SHELL'S "GET BASE STATUS" 


Purpose: Determine whether the specified drive is mapped to a base. 
Available on: All machines. Restrictions: NetWare 4.6 or higher, or Alloy network 
software, must be installed. 


i 
| 
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Registers at call: Return Registers: 
AX = E900h AL = network pathbase 
DX = drive number to check (0 = A:) AH = base flags 


00h drive not currently mapped to a base 
Oh drive is mapped to a permanent base 
02h drive is mapped to a temporary base 
03h drive exists locally 


Conflicts: None known. 


INTERRUPT 2th - Function E9h, Subfunction 05h 
MAP A FAKE ROOT DIRECTORY 


Purpose: Specify a directory which will henceforth appear to be the root directory of the specified drive. 


Available on: All machines. Restrictions: NetWare shell 3.01 or higher must be 
installed. 
Registers at call: Return Registers: 
AX = B905h CF set on error 
BL = drive number (O=default, [=A:, ...) AL = error code (03h, OFh, | 1h) (see DOS 
DS:DX -> ASCIZ path for fake root (may include Function 59h, chapter 8) 
server name or be empty) CF clear if successful 


Details: If the drive is not currently mapped, a drive mapping will be created. 
Conflicts: None known, 
See Also: Function E9h Subfunction 06h 


INTERRUPT 21h - Function E9h, Subfunction 06h 
DELETE FAKE ROOT DIRECTORY 


Purpose: Stop pretending that a subdirectory is the root directory of the specified drive. 


Available on: All machines. Restrictions: NetWare shell 3.01 or higher must be 
installed, 

Registers at call: Return Registers: unknown. 

AX = B906h 


BL = drive number (O=default, 1=A,, ...) 
Details: The drive remains mapped. 
Conflicts: None known. 

See Also: Function E9h Subfunction 0Sh 


INTERRUPT 21h - Function E9h, Subfunction 07h 
GET RELATIVE DRIVE DEPTH 


Purpose: Determine how deep the directory tree extends below the directory which currently appears to be the root 


directory. 

Available on: All machines. Restrictions; NetWare shell 3.01 or higher must be 
installed. 

Registers at call; Return Registers: 

AX = E907h AL = number of directories below the fake root 

BL = drive number (O=default, 1=A;, ...) FFh if no fake root assigned 

Conflicts: None known, 

See Also: Function E9h Subfunction 05h 

INTERRUPT 21h - Function E9h, Subfunction 08h 

SET SHOW DOTS 

Purpose: Specify whether directory searches will return the "." and ".." entries. 

Available on: All machines. Restrictions: NetWare shell 3.01 or higher must be 


installed. 
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Registers at call: Return Registers: 
AX = E908h BL = previous show-dots setting 
BL = 00h: don't return ‘.’ or '..' during directory 
scans 
= nonzero: directory scans will return '.' or '..’ 
entries 


Conflicts: None known. 
INTERRUPT 21h - Function EAh 
RETURN SHELL VERSION 


Purpose: Determine which version of the NetWare shell is running, and which hardware and operating system it is 
running under. 


Available on: All machines. Restrictions: NetWare 4.6 or higher, or Alloy network 
software, must be installed. 

Registers at call: Return Registers: 
AH =EAh AH = operating system (00h = MSDOS) 
AL = return version environment string AL = hardware type 

OOh: don't retum string 00h IBM PC 

nonzero: return string in 40-byte buffer pointed Olh Victor 9000 

to by ES:DI BH = major shell version 


BL = minor shell version 
CH = (v3.01+) shell type 
00h conventional memory 
Olh expanded memory 
02h extended memory 
CL = shell revision number 
if AL nonzero on entry, the ES:DI buffer is filled with 
three null-terminated entries: 
major operating system 
version 
hardware type 
Conflicts: DoubleDOS (chapter 16). 


INTERRUPT 21h - Function EBh 


LOG FILE 
Purpose: Add the specified file to the log table and optionally prohibit other processes access to the file. 
Available on: All machines. Restrictions: NetWare 4.6 or higher, or Alloy network 
software, must be installed. 

Registers at call: Return Registers: 
AH =EBh AL = error code 
DS:DX -> ASCIZ filename 00h successful 
if function C6h lock mode 01h: 96h no dynamic memory for file 

AL = flags FEh timed out 

00h log file only FFh failed 


Oh lock as well as log file 
BP = lock timeout in timer ticks (1/18 second) 
Conflicts: DoubleDOS (chapter 16). 
See Also: Functions CAh and ECh 


INTERRUPT 21h - Function ECh 
RELEASE FILE 


Purpose: Unlock the specified file, permitting other processes access. 
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Available on: All machines. Restrictions: NetWare 4.6 or higher, or Alloy network 
software, must be installed. 

Registers at call: Return Registers: none 

AH = ECh 


DS:DX -> ASCIZ filename 
Conflicts: DoubleDOS (chapter 16), "Terror" virus (chapter 34). 
See Also: Function EBh 


INTERRUPT 21h - Function EDh 


CLEAR FILE 

Purpose: Unlock the specified file and remove it from the log table. 

Available on: All machines. Restrictions: NetWare or Alloy network software 
must be installed. 

Registers at call: Return Registers: 

AH = EDh AL = error code 

DS:DX -> ASCIZ filename 

Conflicts: None known, 

See Also: Functions CEh and EBh 

INTERRUPT 21h - Function EEh 

GET PHYSICAL STATION NUMBER 

Purpose: Determine the physical network address of the caller's machine. 

Available on; All machines. Restrictions: NetWare 4.6 or higher, or Alloy network 
software, must be installed. 

Registers at call: Return Registers: 

AH =EEh CX:BX:AX = six-byte address 

Conflicts; DoubleDOS (chapter 16), "Jerusalem-G" virus (chapter 34). 

INTERRUPT 21h - Function EFh 

GET DRIVE INFO 

Purpose: Determine information about the attached drives, 

Available on: All machines. Restrictions; Advanced NetWare 1.0 or higher must 
be installed. 

Registers at call: Return Registers: 

AH = EFh ES:DI -> shell status table 


AL = subfunction 
00h get drive handle table 
Oth get drive flag table (Table 20-9) 
02h get drive connection ID table 
03h get connection ID table (Table 20-10) 
04h get file server name table 
Details: The drive handle, flag, and connection ID tables each contain 32 entries 


Table 20-9. Values in drive flag table: 


Value Meaning 

00h drive is not mapped 

Olh permanent network drive 

02h temporary network drive 

80h mapped to local drive 

81h local drive used as permanent network drive 


82h local drive used as temporary network drive 
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Table 20-10. Format of Connection ID Table: 


Offset Size Description 
00h BYTE in use flag: 
E0h AES temporary 


F8h IPX in critical section 
FAh processing 


FBh holding 
FCh AES waiting 
FDh waiting 
FEh receiving 
FFh sending 
Oth BYTE order number 
02h DWORD file server's network address (high byte first) 
06h 6BYTEs _ file server's node address (high byte first) 
0Ch WORD socket number (high byte first) 
OEh WORD base receive timeout in clock ticks (high byte first) 
10h 6BYTEs _ preferred routing node (high byte first) 
16h BYTE packet sequence number 
17h BYTE connection number 
18h BYTE connection status (FFh if active) 
19h WORD maximum receive timeout in clock ticks (high byte first) 
IBh SBYTEs reserved 
INTERRUPT 21h - Function FOh, Subfunctions 00h thru 05h 
CONNECTION ID 
Purpose: Determine or specify the identifier for the current connection. 
Available on: All machines. Restrictions: Advanced NetWare 1.0 or higher must 
be installed, 
Registers at call: Return Registers: 
AH = F0h AL = selected file server 
AL = subfunction 
00h set preferred connection ID 
Oth get preferred connection ID 
02h get default connection ID 
03h LPT capture active 
04h set primary connection ID 
05h get primary connection ID 
DL = preferred file server 
Conflicts: DoubleDOS (chapter 16), "Frere Jacques" virus (chapter 34). 
INTERRUPT 21h - Function F1h, Subfunctions 00h thru 02h 
FILE SERVER CONNECTION 
Purpose: Control communication with the file server. 
Available on: All machines, Restrictions; Advanced NetWare 1.0 or higher must 
be installed. 
Registers at call: Return Registers: 
AH=Flh AL = completion code 


AL = subfunction 
00h attach to file server 
DL = preferred file server 
Olh detach from file server 
02h logout from file server 
Conflicts: DoubleDOS (chapter 16). 
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INTERRUPT 21h - Function F2h 
SHELL INTERFACE MULTIPLEXOR 


Purpose: Access other net interface functions which were accessed via a separate AH function in older versions. 


Available on: All machines. Restrictions: NetWare shell version 3.01 or higher 
must be installed. 

Registers at call: Return Registers: unknown. 

AH =F2h 


AL = function 
15h broadcast services (see Function Elh) 
17h connection control (see Function E3h) 
DS:SI -> request buffer 
ES:DI -> reply buffer 
Details: The function number in AL is added to CCh to get the old function number which is desired. 
Conflicts: DoubleDOS (chapter 16). 


INTERRUPT 21h - Function F3h 


FILE SERVER FILE COPY 
Purpose: Copy data from one file to another without involving the workstation in the copy. 
Available on: All machines. Restrictions: Advanced NetWare version 2.0 or higher 
must be installed. 
Registers at call: Return Registers: 
AH =F3h AL = status/error code 
ES:DI -> request string (Table 20-11) CX:DX = number of bytes copied 
Conflicts: DoubleDOS (chapter 16). 
Table 20-11. Format of Request String: 
Offset Size Description 
00h WORD source file handle 
02h WORD destination file handle 
04h DWORD starting offset in source 
08h DWORD _ starting offset in destination 
0Ch DWORD _ number of bytes to copy 
INTERRUPT 2Fh - Function 7Ah, Subfunction 00h 
LOW-LEVEL API (IPX) INSTALLATION CHECK 
Purpose: Determine whether Novell IPX software is installed. 
Available on: All machines, Restrictions: none. 
Registers at call: Return Registers: 
AX = 7A00h AL = 00h not installed 
= FFh installed 


ES:DI -> FAR entry point for routines accessed 
exclusively through INT 7Ah in NetWare versions 
through 2.0a. Call this entry point with the same 
values as INT 7Ah. 

Conflicts: None known. 
See Also: INT 64h, INT 7Ah 


INTERRUPT 2Fh - Function 7Ah, Subfunction 80h 
Unknown Function 


Purpose: unknown. 
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Available on: All machines. Restrictions: NetWare shell version 3.01d must be 
installed. 

Registers at call: Return Registers: nothing 

AX =7A80h 


Details: This function is apparently called on abnormal exit of the shell. 


INTERRUPT 2Fh - Function 7Ah, Subfunction 81h 


Unknown Function 

Purpose: unknown, 

Available on: All machines. Restrictions: NetWare shell version 3.0id must be 
installed. 

Registers at call: Return Registers: apparently nothing 

AX =7A81h 


CX:DX -> unknown in shell's CS (may be callback 
address or data structure) 
Conflicts: None known. 


INTERRUPT 2Fh - Function 7Ah, Subfunction 85h 
BROADCAST INFORM 


Purpose: Called by the NetWare shell to inform any interested programs that a broadcast message has been 
received. 


Available on: All machines. Restrictions: NetWare shell version 3.01 must be 
installed. 

Registers at call: Return Registers: 

AX =7A85h CX = 0000h if broadcast message handled by another 

CX = broadcast server number program 


CX unchanged if broadcast not handled 
Conflicts: None known, 


INTERRUPT 2Fh - Function 7Ah, Subfunction FEh 


Unknown Function 

Purpose: unknown. 

Available on: All machines. Restrictions: NetWare shell version 3.01d must be 
installed. 

Registers at call: Return Registers: 

AX = 7AFEh AL = FFh 22? 

other unknown. 

Conflicts: None known. 

INTERRUPT 2Fh - Function 7Ah, Subfunction FFh 

Unknown Function 

Purpose: unknown. 

Available on: All machines. Restrictions: NetWare shell version 3.01d must be 
installed. 

Registers at call: Return Registers: 

AX = 7AFFh CX unchanged if unknown conditions 

BX = 0001h 


CX = offset of unknown data or function 
DX = offset of unknown data or function 
Conflicts: None known. 
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INTERRUPT 2Fh - Function COh, Subfunction 00h 
Novell ODI Link Support Layer (LSL.COM) INSTALLATION CHECK 


Purpose: Determine if LSL.COM is present. 


Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AX = C000h AL = FFh 


ES:BX -> call entry point 

BS:SI -> signature string "LINKSUP$" 
Details: LSL.COM may use any multiplex number between COh and FFh; it searches for itself in that range, and 
installs using the first free multiplex number in the range if it is not already loaded. 
Conflicts: None known. 


INTERRUPT 44h 
Novell NetWare - HIGH-LEVEL LANGUAGE AP! 


Purpose: Communication between applications and NetWare. 


Available on: Novell networks. Restrictions: none. 

Registers at call: unknown. Return Registers: n/a. 

Conflicts: PCjr character font vector (chapter 5), IBM 3270-PC API (chapter 26), Z100 master 8259 (chapter 2). 
INTERRUPT 64h 

LOW-LEVEL API 

Purpose: Provide direct packet-level access to the network, 

Available on: All machines. Restrictions: Advanced NetWare version 2.0a or 


earlier must be installed. 
Details: This interrupt is equivalent to INT 7Ah for NetWare versions through 2.0a only; later versions do not use 
this interrupt for IPX/SPX access, instead getting an entry point from INT 2Fh Function 7Ah Subfunction 00h. 
Conflicts; None known. 
See Also: INT 2Fh Function 7Ah Subfunction 00h, INT 7Ah 


INTERRUPT 6Bh 
Novell NASI/NACS 


Purpose: Emulate a serial port over the network, The calls for this interrupt are described in chapter 7. 


INTERRUPT 6Fh 
Novell NetWare - PCOX API (3270 PC terminal interface) 


Purpose: IBM 3270 emulation. 


Available on: All machines. Restrictions: Applicable network software must be 
installed, 

Registers at call: unknown. Return Registers: unknown. 

Conflicts: None known. 

INTERRUPT 7Ah 


LOW-LEVEL API - Notes 

Purpose: The functions of this interrupt provide direct packet-level IPX/SPX access to the network, 

Available on: All machines. Restrictions: NetWare IPX and/or SPX driver must be 
installed. 

Details: This interrupt is used for IPX/SPX access in NetWare versions through 2.0a; in later versions, you should 

use INT 2Fh Function 7Ah Subfunction 00h to get an entry point. For both INT 7Ah and the FAR entry point, BX 

contains the function number; IPX is sometimes called internally with BX bit 15 set. 

Conflicts: IBM3270 Emulation (chapter 26), Topware Network Operating System (chapter 27), AutoCAD Device 

Interface (chapter 36). 
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See Also: INT 2Fh Function 7Ah Subfunction 00h, INT 64h 
INTERRUPT 74h - Function 0000h 


OPEN SOCKET 
Purpose: Establish a connection over the network. 
Available on: All machines. Restrictions: NetWare low-level (IPX) driver must be 
installed. 
Registers at call: Return Registers: 
BX = 0000h AL = return code 
AL = mode 00h success 
00h open until close or terminate DX = socket number 
FFh open until close FEh socket table full 
DX = socket number (high byte in DL) FFh socket already open 


0000h dynamic allocation 

else socket to open 
Conflicts: IBM3270 Emulation (chapter 26), Topware Network Operating System (chapter 27), AutoCAD Device 
Interface (chapter 36). 
See Also: Function 0001h 


INTERRUPT 7Ah - Function 0001h 


CLOSE SOCKET 

Purpose: Terminate a connection over the network, 

Available on: All machines, Restrictions: NetWare low-level (IPX) driver must be 
installed, 

Registers at call: Return Registers: n/a. 

BX =0001h 


DX = socket (high byte in DL) 

Conflicts: IBM3270 Emulation (chapter 26), Topware Network Operating System (chapter 27), AutoCAD Device 
Interface (chapter 36). 

See Also: Function 0000h 


INTERRUPT 7Ah - Function 0002h 
GET LOCAL TARGET 


Purpose: Determine the address in the caller's own network to which to transmit in order to reach the specified 
machine. 


Available on: All machines. Restrictions: NetWare low-level (IPX) driver must be 
installed. 
Registers at call: Return Registers: 
BX = 0002h AL = return code 
ES:SI -> target internetwork address 00h success 
ES:DI -> 6-byte buffer for local target CX = expected one-way transfer time (clock 
ticks) 


ES:DI -> local target 

FAh unsuccessful 
Details: The internetwork address consists of a 4-byte network address followed by a 6-byte node address. The local 
target is only a 6-byte node address. If the target is in the same network, the local target is just the node address of 
target; otherwise, the local target is the node address of the bridge that leads to the target. 
Conflicts: I1BM3270 Emulation (chapter 26), Topware Network Operating System (chapter 27), AutoCAD Device 
Interface (chapter 36). 
See Also: Function 0009h 
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INTERRUPT 7Ah - Function 0003h 


SEND PACKET 

Purpose: Transmit data over the network. 

Available on: All machines. Restrictions: NetWare low-level (IPX) driver must be 
installed, 

Registers at call: Return Registers: n/a. 

BX = 0003h 


ES:SI -> Event Control Block (Table 20-12) 
Conflicts: [BM3270 Emulation (chapter 26), Topware Network Operating System (chapter 27), AutoCAD Device 


Interface (chapter 36). 
See Also: Functions 0004h and 0OOFh 


Table 20-12. Format of Event Contral Block: 


Offset Size Description 
00h DWORD _ Link 
04h DWORD  -> Event Service Routine (00000000h if none) 
08h BYTE in use flag 
09h BYTE completion code 
OAh WORD socket (high byte first [big-endian]) 
0Ch 4BYTEs IPX workspace 
10h 12 BYTEs driver workspace 
1Ch 6BYTEs immediate local node address 
22h WORD fragment count 
26h varies fragment descriptors: 
Offset Size Description 


00h DWORD -> fragment data 

04h WORD size of fragment in bytes. 
Details: The Event Service Routine (ESR) is a far procedure that is called when the ECB has been handled. On call, 
the in use flag is zero if the ECB has been handled, non-zero otherwise. If the flag is zero, the completion code holds 
the result of the event: 


Table 20-13. Values of ESR Completion Codes: 


Value Meaning 

00h success 

F9h event should not be cancelled 
FCh cancelled 

FDh malformed packet 

FEh packet undeliverable 

FFh physical error 


The first fragment should start with an IPX header (see below). All fragments are concatenated and sent in one 
piece. Node address FF FF FF FF FF FF broadcasts to all nodes. 


Event Service Routine called with: 
AL = caller's identity (00h = AES, FFh = IPX) 
ES:SI -> event control block 
interrupts disabled 


Table 20-14. Format of IPX Header: 


Offset Size Description 
00h WORD checksum (high byte first [big-endian]) 
02h WORD length in bytes (high byte first) of total packet 


04h BYTE transport control 


20-28 Novell NetWare 


Table 20-14. Format of IPX Header (continued) 


Offset Size Description 
05h BYTE packet type 
00h unknown packet type 
O1h routing information packet 
02h echo packet 
03h error packet 
04h packet exchange packet (always use this one) 
05h SPX packet 
Lh (used internally) 
06h 10 BYTES destination internetwork address 
10h WORD destination socket (high byte first) 
12h 10 BYTES source internetwork address 
1Ch WORD source socket 
INTERRUPT 7Ah - Function 0004h 
LISTEN FOR PACKET 
Purpose: Await data arriving over the network. 
Available on: All machines, Restrictions: NetWare low-level (IPX) driver must be 
installed, 
Registers at call: Return Registers: n/a. 
BX = 0004h 


ES:SI -> Event Control Block (Table 20-12) 

Conflicts; IBM3270 Emulation (chapter 26), Topware Network Operating System (chapter 27), AutoCAD Device 
Interface (chapter 36). 

See Also: Function 0003h 


INTERRUPT 7Ah - Function 0005h 


SCHEDULE IPX EVENT 

Purpose: Add an event to the IPX scheduler. 

Available on: All machines. Restrictions: NetWare low-level (IPX) driver must be 
installed. 

Registers at call: Return Registers: n/a. 

BX = 0005h 


AX = delay time 

ES:SI -> Event Control Block (Table 20-12) 

Conflicts: IBM3270 Emulation (chapter 26), Topware Network Operating System (chapter 27), AutoCAD Device 
Interface (chapter 36). 

See Also: Functions 0006h and 0007h 


INTERRUPT 7Ah - Function 0006h 


CANCEL EVENT 

Purpose: Remove a previously-added event. 

Available on: All machines. Restrictions: NetWare low-level (IPX) driver must be 
installed, 

Registers at call: Return Registers: 

BX = 0006h AL = return code 

ES:SI -> Event Control Block (Table 20-12) 00h success 


F9h event in use 

FFh unsuccessful, event not in use 
Conflicts: IBM3270 Emulation (chapter 26), Topware Network Operating System (chapter 27), AutoCAD Device 
Interface (chapter 36). 
See Also: Function 0005h 
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INTERRUPT 7Ah - Function 0007h 


SCHEDULE SPECIAL EVENT 

Purpose: Add a non-IPX event to the scheduler. 

Available on: All machines. Restrictions: NetWare low-level (IPX) driver must be 
installed. 

Registers at call: Return Registers: n/a. 

BX = 0007h 


AX = delay time 

ES:SI -> Event Control Block (Table 20-12) 

Conflicts: IBM3270 Emulation (chapter 26), Topware Network Operating System (chapter 27), AutoCAD Device 
Interface (chapter 36). 

See Also: Function 0006h 


INTERRUPT 7Ah - Function 0008h 


GET INTERVAL MARKER 

Purpose: Network action timing. 

Available on: All machines. Restrictions: NetWare low-level (IPX) driver must be 
installed. 

Registers at call: Return Registers: 

BX = 0008h AX = interval marker in clock ticks 


Conflicts: IBM3270 Emulation (chapter 26), Topware Network Operating System (chapter 27), AutoCAD Device 
Interface (chapter 36). 


INTERRUPT 7Ah - Function 0009h 
GET INTERNETWORK ADDRESS 


Purpose: Determine the caller's full address in a set of interconnected networks. 


Available on: All machines. Restrictions: NetWare low-level (IPX) driver must be 
installed. 

Registers at call: Return Registers: 

BX = 0009h ES:SI -> own internetwork address 


BS:SI -> 10-byte buffer 

Conflicts: IBM3270 Emulation (chapter 26), Topware Network Operating System (chapter 27), AutoCAD Device 
Interface (chapter 36). 

See Also: Functions 0002h and 00OBh 


INTERRUPT 7Ah - Function 000Ah 


RELINQUISH CONTROL 

Purpose: Indicate to NetWare that the caller is idle. 

Available on: All machines. Restrictions; NetWare low-level (IPX) driver must be 
installed. 

Registers at call: Return Registers: n/a. 

BX =000Ah 


Details: This call permits the IPX driver to do some work. 
Conflicts: IBM3270 Emulation (chapter 26), Topware Network Operating System (chapter 27), AutoCAD Device 
Interface (chapter 36). 


INTERRUPT 7Ah - Function 000Bh 
DISCONNECT FROM TARGET 


Purpose: Terminate a network connection. 
Available on: All machines. Restrictions: NetWare low-level (IPX) driver must be 
installed. 
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Registers at call: Return Registers: n/a. 

BX = 000Bh 

ES:SI -> internetwork address 

Details: This function is only of use in point-to-point networks. 

Conflicts: IBM3270 Emulation (chapter 26), Topware Network Operating System (chapter 27), AutoCAD Device 
Interface (chapter 36). 

See Also: Functions 0002h and 0009h 


INTERRUPT 7Ah - Function 000Ch to 000Eh 
Unknown Internal Functions 


Purpose: unknown. 


Available on: All machines. Restrictions: NetWare low-level (IPX) driver must be 
installed. 
Registers at call: Return Registers: unknown. 


BX = 000Ch to OOOEh 

others, if any, unknown. 

Conflicts: I13M3270 Emulation (chapter 26), Topware Network Operating System (chapter 27), AutoCAD Device 
Interface (chapter 36). 


INTERRUPT 7Ah - Function 000Fh 
internal - SEND PACKET 


Purpose: Transmit data over the network. 


Available on: All machines. Restrictions: NetWare low-level (IPX) driver must be 
installed, 

Registers at call: Return Registers: n/a. 

BX = 000Fh 


ES:SI -> Event Control Block (Table 20-12) 

Details: This call is similar to function 0003h, but apparently does not allow multiple fragments. 

Conflicts: IBM3270 Emulation (chapter 26), Topware Network Operating System (chapter 27), AutoCAD Device 
Interface (chapter 36). 

See Also: Function 0003h 


INTERRUPT 7Ah - Function 0010h 


SPX INSTALLATION CHECK 

Purpose: Determine whether NetWare's SPX module is installed. 

Available on; All machines, Restrictions: NetWare low-level (IPX) driver must be 
installed. 

Registers at call: Return Registers: 

BX = 0010h AL = FFh if SPX loaded 

AL = 00h 

Conflicts: IBM3270 Emulation (chapter 26), Topware Network Operating System (chapter 27), AutoCAD Device 

Interface (chapter 36). 


See Also: Function 0015h 


INTERRUPT 7Ah - Function 0011h 
ESTABLISH SPX CONNECTION 


Purpose: Create a new network connection using the SPX reliable sequenced packet service. 


Available on: All machines. Restrictions: NetWare low-level (IPX) driver must be 
installed. 

Registers at call: Return Registers: 

BX = 0011h DX = assigned connection number 


AL = retry count 
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AH = watchdog flag 

ES:SI -> Event Control Block (Table 20-12) 

Details: There should always be at least two SPX ECB's listening to a socket, so that NetWare can perform its 
internal packet exchanges. The first fragment should start with an SPX header (Table 20-15). 

All destination addresses should be filled in, 

Conflicts: IBM3270 Emulation (chapter 26), Topware Network Operating System (chapter 27), AutoCAD Device 
Interface (chapter 36). 

See Also: Functions 0000h, 0012h, 0013h, and 0014h 


Table 20-15. Format of SPX Header: 


Offset Size Description 

00h WORD checksum (high byte first [big-endian]) 
02h WORD length in bytes of total packet (high byte first) 
04] BYTE transport control 

05 BYTE packet type 

06h 10 BYTEs destination internet address 

10] WORD destination socket (high byte first) 

12) 10 BYTEs source internet address 

Ch WORD source socket (high byte first) 

1Eh BYTE connection control 

1Fh BYTE datastreamtype 

20h WORD source connection ID 

22] WORD destination connection ID 

24h WORD sequence number 

26h WORD acknowledge number 

28) WORD allocation number 





INTERRUPT 7Ah - Function 0012h 
LISTEN FOR SPX CONNECTION 


Purpose: Await a request to establish a network connection using the SPX service. 


Available on: All machines. Restrictions: NetWare low-level (IPX) driver must be 
installed. 

Registers at call: Return Registers: n/a. 

BX = 0012h 


AL = retry count 

AH = watchdog flag 

ES:SI -> Event Control Block (Table 20-12) 

Details: There should always be at least two SPX ECB's listening to a socket, so that NetWare can perform its 
internal packet exchanges. 

Conflicts: [8M3270 Emulation (chapter 26), Topware Network Operating System (chapter 27), AutoCAD Device 
Interface (chapter 36). 

See Also: Functions 001 1h, 0013h, and 0014h 


INTERRUPT 7Ah - Function 0013h 
TERMINATE SPX CONNECTION 


Purpose: Close the specified network connection using the SPX service. 


Available on: All machines. Restrictions: NetWare low-level (IPX) driver must be 
installed, 

Registers at call: Return Registers: n/a. 

BX = 0013h 


DX = connection ID to terminate 

ES:SI -> Event Control Block (Table 20-12) 

Conflicts: IBM3270 Emulation (chapter 26), Topware Network Operating System (chapter 27), AutoCAD Device 
Interface (chapter 36), 
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See Also: Functions 001 1h, 0012h, and 0014h 
INTERRUPT 7Ah - Function 0014h 


ABORT SPX CONNECTION 

Purpose: Shut down the specified network connection immediately. 

Available on: All machines. Restrictions: NetWare low-level (IPX) driver must be 
installed. 

Registers at call: Return Registers: unknown. 

BX =0014h 


DX = connection ID to terminate 

Details: This function does not tell the other side that the connection has been terminated. 

Conflicts: IBM3270 Emulation (chapter 26), Topware Network Operating System (chapter 27), AutoCAD Device 
Interface (chapter 36). 

See Also: Functions 0011h and 0013h 


INTERRUPT 7Ah - Function 0015h 


GET SPX STATUS 
Purpose: Determine the current status of the SPX driver for the specified connection. 
Available on: All machines. Restrictions: NetWare low-level (IPX) driver must be 
installed, 

Registers at call; Return Registers: 
BX =0015h AL = return code 
DX = connection ID 00h connection still valid 
ES:SI -> status buffer (Table 20-16) ES:SI -> status buffer filled 
Conflicts: IBM3270 Emulation (chapter 26), Topware Network Operating System (chapter 27), AutoCAD Device 
Interface (chapter 36). 
See Also: Functions 0010h 
Table 20-16. Format of Status Buffer: 
Offset Size Description 

00h BYTE status 

Olh BYTE flag 

02h WORD source connection (high byte first [big-endian]) 

O4h WORD destination connection (high byte first) 

06h WORD sequence number (high byte first) 

08h WORD acknowledge number (high byte first) 

OAh WORD allocation number (high byte first) 

0Ch WORD remote acknowledge number (high byte first) 

OEh WORD remote allocation number (high byte first) 

10h WORD connection socket (high byte first) 

12h 6BYTEs immediate node address 

18h 10BYTEs destination internet address 

22h WORD retransmit count (high byte first) 

24h WORD estimated roundtrip delay 

26h WORD retransmitted packets 

28h WORD suppressed packets 
INTERRUPT 7Ah - Function 0016h 
SEND SPX PACKET 
Purpose: Transmit data over an SPX network connection. 
Available on: All machines, Restrictions: NetWare low-level (IPX) driver must be 

installed. 

Registers at call: Return Registers; n/a. 


BX = 0016h 


Novell NetWare 20-33 


DX = connection ID 

ES;SI -> Event Control Block (Table 20-12) 

Details: CX may need to be 0001h. 

Conflicts: IBM3270 Emulation (chapter 26), Topware Network Operating System (chapter 27), AutoCAD Device 
Interface (chapter 36). 

See Also: Functions 0011h and 0017h 


INTERRUPT 7Ah - Function 0017h 


LISTEN FOR SPX PACKET 

Purpose: Await data arriving over the specified SPX network connection. 

Available on: All machines. Restrictions: NetWare low-level (IPX) driver must be 
installed. 

Registers at call: Return Registers: n/a. 

BX = 0017h 


DX = connection ID 

ES:SI -> Event Control Block (Table 20-12) 

Details: CX may need to be 0001h. 

Conflicts: IBM3270 Emulation (chapter 26), Topware Network Operating System (chapter 27), AutoCAD Device 
Interface (chapter 36). 

See Also: Functions 001 1h and 0016h 


INTERRUPT 7Ah - Functions 0018h to 001Bh 
Unknown Internal Functions 


Purpose: unknown. 


Available on: All machines. Restrictions: NetWare low-level (IPX) driver must be 
installed, 
Registers at call: Return Registers: unknown. 


BX = 0018h to 001Bh 

others, if any, unknown. 

Conflicts: 18M3270 Emulation (chapter 26), Topware Network Operating System (chapter 27), AutoCAD Device 
Interface (chapter 36). 
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LANtastic Network Operating System 


LANtastic is a low-cost network by Artisoft, Inc. for a small to medium number of machines. 


INTERRUPT 21h - Function 5Dh, Subfunctions 07h through 09h 
Printer Redirection 


These functions are identical to the MSDOS implementation, and are described in chapter 8. 


INTERRUPT 21h - Function 5Eh, Subfunctions 00h and 01h 
Network Machine Name 


These functions are identical to the MSDOS implementation, and are described in chapter 8. 


INTERRUPT 21h - Function 5Fh, Subfunctions 02h through 04h 
Redirection 


These functions are identical to the MSDOS implementation, and are described in chapter 8. 


INTERRUPT 21h - Function 5Fh, Subfunction 80h 


GET LOGIN ENTRY 
Purpose: Determine the name of the machine on which the user is logged in. 
Available on: All machines. Restrictions: LANtastic network software must be 

installed. 
Registers at call: Return Registers: 
AX = SF80h CF clear if successful 
BX = login entry index (0-based) buffer filled with machine name ('N" prefix 
ES:DI - > 16-byte buffer for machine name removed) 

DL = adapter number (v3+) 
CF set on error 


AX = error code 
BX = next login entry index (BX-1 is current 


index) 
Conflicts: None known. 
INTERRUPT 21h - Function 5Fh, Subfunction 81h 
LOGIN TO SERVER 
Purpose: Authenticate user to remote machine. 
Available on: All machines. Restrictions: LANtastic network software must be 
installed, 
Registers at call: Return Registers: 
AX = 5F81th CF clear if successful 
ES:DI - > ASCIZ login path followed immediately CF set on error 
by ASCIZ password AX = error code 


BL = adapter number 
FFh try all valid adapters 
00h-03h try only specified adapter 


{ 
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Details: The login path is of the form '\machine". 
Conflicts: None known. 
See Also: Function 5Fh Subfunctions 82h and 84h 


INTERRUPT 21h - Function 5Fh, Subfunction 82h 


LOGOUT FROM SERVER 

Purpose: Terminate the current session with the indicated remote machine. 

Available on: All machines. Restrictions: LANtastic network software must be 
installed. 

Registers at call: Return Registers: 

AX = 5F82h CF clear if successful 

ES:DI -> ASCIZ server name (in form "\machine") CF set on error 


AX = error code 
Conflicts: None known. 
See Also: Function 5Fh Subfunction 81h 


INTERRUPT 21h - Function 5Fh, Subfunction 83h 


GET USERNAME ENTRY 
Purpose: Determine name under which the user is logged into the specified remote machine, 
Available on: All machines. Restrictions: LANtastic network software must be 
installed. 
Registers at call: Return Registers: 
AX = 5F83h CF clear if successful 
BX = login entry index (0-based) DL = adapter number (v3+) 
ES:DI -> 16-byte buffer for username currently CF set on error 
logged into AX = error code 
BX = next login entry index (BX-1 is current 
index) 


Conflicts: None known. 


INTERRUPT 21h - Function 5Fh, Subfunction 84h 
GET INACTIVE SERVER ENTRY 


Purpose: Determine the name of an available server which the user is not currently logged into. 


Available on: All machines. Restrictions: LANtastic network software must be 
installed. 
Registers at call: Return Registers: 
AX = SF84h CF clear if successful 
BX = server index not currently logged into DL = adapter number to non-logged in server is on 
ES:DI -> 16-byte buffer for server name which is CF set on error 
available for logging in to ('\" prefix omitted) AX = error code 


Conflicts: None known. 
See Also: Function 5Fh Subfunction 81h 


INTERRUPT 21h - Function 5Fh, Subfunction 85h 


CHANGE PASSWORD 
Purpose: Specify a new password for the user on the specified remote machine. 
Available on: All machines, Restrictions: LANtastic network software must be 
installed, 
Registers at call: Return Registers: 
AX = 5F85h CF clear if successful 
ES:DI -> buffer containing ‘\machine" 00h CF set on error 
“newpassword"” 00h AX = error code 


Details: The caller must be logged into the named machine. 
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Conflicts: None known. 


INTERRUPT 21h - Function 5Fh, Subfunction 86h 


DISABLE ACCOUNT 
Purpose: Prevent further use of an account until it is manually re-enabled. 
Available on: All machines. Restrictions: LANtastic network software must be 
installed. 
Registers at call: Return Registers: 
AX = 5F86h CF clear if successful 
ES:DI -> ASCIZ machine name and password in CF set on error 
form '\machine" AX = error code 


Details: The caller must be logged into the named machine and concurrent logins must be set to 1 by NET_MGR. 
Re-enabling the account requires the system manager. 
Conflicts: None known. 


INTERRUPT 21h - Function 5Fh, Subfunction 87h 





GET ACCOUNT 

Purpose: Determine information about the currently active account on the specified machine. 

Available on: All machines. Restrictions: LANtastic network software version 3.0 

or higher must be installed. 

Registers at call; Return Registers: 

AX = 5F87h CF clear if successful 

DS:SI -> 128-byte buffer for account information CF set on error 

(Table 21-1) AX =error code 

ES:DI -> ASCIZ machine name in form '\machine" BX destroyed 

Details: The caller must be logged into the specified machine. 

Conflicts: None known. 

Table 21-1, Format of User Account Structure: 

Offset Size Description 

00h 16BYTEs blank-padded username 

10h 16 BYTEs reserved (00h) 

20h 32 BYTEs user description 

40h BYTE privilege bits: 
bit 7: bypass access control lists 
bit 6; bypass queue protection 
bit 5: treat as local process 
bit 4: bypass mail protection 
bit 3: allow audit entry creation 
bit 2: system manager 

4th BYTE maximum concurrent users 

42h 42 BYTEs bit map for disallowed half hours, beginning on Sunday (bit set if half-hour not an allowed 
time) 

6Ch WORD internal (0002h) 

6Eh 2 WORDs | last login time 

72h 2WORDs account expiration date (MSDOS-format year/month:day) 

76h 2 WORDs password expiration date (0 = none) 

TAh BYTE number of days to extend password after change (1-31) 

7Bh , SBYTEs _ reserved 

INTERRUPT 21h - Function 5Fh, Subfunction 97h 

COPY FILE 


Purpose: Copy data from one file into another. 
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Available on: All machines. Restrictions; LANtastic network software must be 
installed. 
Registers at call: Return Registers: 
AX = 5F97h CF clear if successful 
CX:DX = number of bytes to copy (FFFFFFFFh = AX:DX = number of bytes copied 
entire file) CF set on error 
SI = source file handle AX = error code 


DI = destination file handle 
Details: The file copy is performed by the server. 
Conflicts: None known. 


INTERRUPT 21h - Function 5Fh, Subfunction 98h 
SEND UNSOLICITED MESSAGE 


Purpose: Queue a message for another user, possibly on another machine. 


Available on: All machines. Restrictions: LANtastic network software must be 
installed. 

Registers at call: Return Registers: 

AX = 5F98h CF clear if successful 

DS:SI -> message buffer (Table 21-2) CF set on error 


AX = error code 
Conflicts: None known. 
See Also: Function 5Fh Subfunction 99h 


Table 21-2. Format of Message Buffer: 


Offset Size Description 
00h BYTE reserved 
Olh BYTE message type: 
00h general 
Olh server warning 
02h-7Fh reserved 
80h-FFh user-defined 
02h 16BYTEs ASCIZ destination machine name 
12h 16BYTEs ASCIZ server name which user must be logged into 
22h 16BYTEs ASCIZ user name 
32h 16BYTEs ASCIZ originating machine name (filled in when received) 
42h 80 BYTEs message text 


INTERRUPT 21h - Function 5Fh, Subfunction 99h 
GET LAST RECEIVED UNSOLICITED MESSAGE 


Purpose: Retrieve a message from another user. 


Available on: All machines. Restrictions: LANtastic network software must be 
installed. 

Registers at call: Return Registers: 

AX = 5F99h CF clear if successful 

ES:DI -> messsage buffer (Table 21-2) CF set on error 


AX = error code 
Conflicts: None known. 
See Also: Function 5Fh Subfunction 98h 


INTERRUPT 21h - Function 5Fh, Subfunction 9Ah 
GET MESSAGE PROCESSING FLAGS 


Purpose: Determine what processing is performed when an unsolicited message is received. 


Available on: All machines. 


Registers at call: 
AX = SFOAh 


Conflicts: None known. 
See Also: Function 5Fh Subfunctions 9Bh and 9Ch 


INTERRUPT 21h - Function 5Fh, Subfunction 9Bh 
SET MESSAGE PROCESSING FLAG 
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Restrictions: LANtastic network software must be 


installed. 


Return Registers: 
CF clear if successful 


DL = bits describing processing for received 
unsolicited messages 
bit 0: beep before message is delivered 
1: deliver message to message service 
2: pop up message automatically (v3+) 


CF set on error 


AX = error code 


Purpose: Specify what processing is to be performed when an unsolicited message is received. 


Available on: All machines. 


Registers at call: 

AX = 5F9Bh 

DL = bits describing processing for received 
unsolicited messages (see Function 5Fh 
Subfunction 9Ah) 

Conflicts: None known, 

See Also: Function 5Fh Subfunction 9Ah 


INTERRUPT 21h - Function 5Fh, Subfunction 9Ch 
POP UP LAST RECEIVED MESSAGE 


Purpose: Display a message from another user. 
Available on: All machines. 


Registers at call: 

AX = 5F9Ch 

CX = time to leave on screen in clock ticks 

DH = 0-based screen line on which to place 
message 


Restrictions: LANtastic network software must be 
installed. 
Return Registers: 
CF clear if successful 
CF set on error 
AX = error code 


Restrictions: LANtastic version 3.0 or higher must be 
installed. 
Return Registers: 
CF clear if successful 
CF set on error 
AX = error code (OBh) 


Details: The original screen contents are restored when the message is removed, 


Conflicts: None known. 
See Also: Function 5Fh Subfunction 9Ah 


INTERRUPT 21h - Function 5Fh, Subfunction AOh 
GET QUEUE ENTRY 


Purpose: Determine the type of, and other information about, an entry in the specified server's queue. 


Available on: All machines, 


Registers at call; 

AX = SFAOh 

BX = queue entry index (0000h is first entry) 
DS:SI -> buffer for queue entry (Table 21-3) 
ES:DI -> ASCIZ server name in form '\name"” 


Conflicts: None known, 


Restrictions: LANtastic network software must be 
installed. 
Return Registers: 
CF clear if successful 
CF set on error 
AX = error code 
BX = entry index for next queue entry 
(BX-1 is current index) 
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See Also: Function 5Fh Subfunctions Alh and A2h 


Table 21-3. Format of Queue Entry: 


Offset Size Description 
00h BYTE status of entry: 
00h empty 
Olh being updated 


02h being held 
03h waiting for despool 
04h being despooled 
OSh canceled 
O6h spooled file could not be accessed 
O7h destination could not be accessed 
O8h rush job 
Olh DWORD size of spooled file 
05h BYTE type of entry: 
00h printer queue file 
Olh message 
02h local file 
03h remote file 
04h to remote modem 
05h batch processor file 
06h BYTE output control 
bit 6: don't delete (for mail) 
bit 5: mail file contains voice mail (v3+) 





07h WORD number of copies 

09h DWORD _ sequence number of queue entry 

ODh 48 BYTEs pathname of spooled file 

3Dh 16 BYTEs user who spooled file 

4Dh 16 BYTEs name of machine from which file was spooled 

SDh WORD date file was spooled (see Function 57h Subfunction 00h, chapter 8) 

SFh WORD time file was spooled (see Function 57h Subfunction 00h, chapter 8) 

61h 17 BYTEs ASCIZ destination device or user name 

72h 48 BYTEs comment field 

INTERRUPT 21h - Function 5Fh, Subfunction Ath 

SET QUEUE ENTRY 

Purpose: Modify an entry in a server's queue. 

Available on: All machines. Restrictions: LANtastic network software must be 
installed. 

Registers at call: Return Registers: 

AX =5FAIh CF clear if successful 

BX = handle of opened queue entry CF set on error 

DS:SI -> queue entry (Table 21-3) AX = error code 


Details: The only queue entry fields which may be changed are output control, number of copies, destination device, 
and comment, 

Conflicts: None known. 

See Also: Function 5Fh Subfunctions AOh and A2h 


INTERRUPT 21h - Function 5Fh, Subfunction A2h 


CONTROL QUEUE 
Purpose: Alter print jobs and manipulate the despooling of entries in the specified server's queue. 
Available on: All machines, Restrictions: LANtastic network software must be 


installed. 


Registers at call: 


AX = 5FA2h 


BL = control command 
00h start despooling (privileged) AX = error code 
O1h halt despooling (privileged) 
02h halt despooling at end of job (privileged) 
03h pause despooler at end of job (privileged) 
04h print single job (privileged) 
05h restart current job (privileged) 
06h cancel the current job 


07h hold queue entry 
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Return Registers: 
CF clear if successful 
CF set on error 


08h release a held queue entry 
09h make queue entry a rushed job (privileged) 
CX:DX = sequence number to control (commands 


06h-09h) 


DX = physical printer number (commands 00h-05h) 


00h-02h LPT1-LPT3 


03h,04h COM1,COM2 
other all printers 
ES:DI -> ASCIZ computer name 


Conflicts: None known. 


INTERRUPT 21h - Function 5Fh, Subfunction A3h 
GET PRINTER STATUS 


Purpose: Determine the state of the printer and which print job (if any) it is executing. 


Available on: Ail machines. 


Restrictions: LANtastic version 3.0 or higher must be 


installed. 
Registers at call: Return Registers: 
AX = 5FA3h CF clear if successful 
BX = physical printer number (00h-02h = LPT1- CF set on error 
LPT3, 03h-04h = COM1-COM2) AX = error code 


DS:SI -> buffer for printer status (Table 21-4) 


BX = next physical printer number 


ES:DI -> ASCIZ server name in form ‘\machine" 


Conflicts: None known. 


Table 21-4. Format of printer status: 


Offset 
00h 


Olh 


03h 
05h 
09h 
ODh 


Size 
BYTE 


WORD 


WORD 
DWORD 
DWORD 
WORD 


Description 


printer state 


bit 7: printer paused 
bits 0-6: 0 printer disabled 
1 will stop at end of job 
2 print multiple jobs 
queue index of print job being despooled; FFFFh if not despooling--ignore all following 
fields 
actual characters per second being output 
number of characters actually output so far 
number of bytes read from spooled file so far 
copies remaining to print 


INTERRUPT 21h - Function 5Fh, Subfunction A4h 
GET STREAM INFO 


Purpose: Determine the state of a stream. 
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Available on: All machines. 


Registers at call: 

AX = 5FA4h 

BX = 0-based stream index number DS:SI -> buffer 
for stream information (Table 21-5) 

ES:DI -> ASCIZ machine name in form "\machine" 

Conflicts: None known. 

See Also: Function 5Fh Subfunction A5h 


Table 21-5. Format of Stream Information: 


Restrictions: LANtastic version 3.0 or higher must be 
installed. 
Return Registers: 
CF clear if successful 
CF set on error 
AX = error code 
BX = next stream number 


Offset Size Description 
00h BYTE queueing of jobs for logical printer (O=disabled,other=enabled) 
Olh 11 BYTEs logical printer resource template (may contain ? wildcards) 


INTERRUPT 21h - Function 5Fh, Subfunction A5h 


SET STREAM INFO 


Purpose: Specify the state of a stream. 
Available on: All machines. 


Registers at call: 

AX = SFASh 

BX = 0-based stream index number 

DS:SI -> buffer containing stream information (see 
Function 5Fh Subfunction A4h) 

ES:DI -> ASCIZ machine name in form '\machine" 

Conflicts: None known. 

See Also: Function 5Fh Subfunction A4h 


INTERRUPT 21h - Function 5Fh, Subfunction A7h 


CREATE USER AUDIT ENTRY 


Purpose: Add an entry to the audit file. 
Available on: All machines. 


Registers at call: 

AX = 5FA7h 

DS:DX -> ASCIZ reason code (max 8 bytes) 

DS:SI -> ASCIZ variable reason code (max 128 
bytes) 

ES:DI -> ASCIZ machine name in form "\machine” 

Conflicts: None known. 


INTERRUPT 21h - Function 5Fh, Subfunction BOh 


GET ACTIVE USER INFORMATION 


Restrictions: LANtastic version 3.0 or higher must be 
installed. 
Return Registers: 
CF clear if successful 
CF set on error 
AX = error code 


Restrictions: LANtastic network software must be 
installed. 
Return Registers: 
CF clear if successful 
CF set on error 
AX = error code 


Purpose: Determine name and last action of a user logged into the specified machine. 


Available on: All machines. 


Registers at call: 

AX = 5FBOh 

BX = server login entry index 

DS:SI -> buffer for active user entry (Table 21-6) 
ES:DI -> ASCIZ machine name in form "\server" 


Restrictions: LANtastic network software must be 
installed. 
Return Registers: 
CF clear if successful 
CF set on error 
AX = error code 
BX = next login index 
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Conflicts: None known. 


Table 21-6. Format of Active User Entry: 


Offset Size Description 
00h WORD virtual circuit number 
02h BYTE _ login state 
bit 0: fully logged in 

1: remote program load login 

3: user can create audit entries 

4: bypass mail protection 

5: treat as local process 

6: bypass queue protection 

7: bypass access control lists 
03h BYTE __ last command issued (Table 21-7) 
04h 5 BYTEs number of I/O bytes (40-bit unsigned number) 
09h 3 BYTEs number of server requests (24-bit unsigned) 
0Ch 16 BYTEs name of user who is logged in 
1Ch 16 BYTEs name of remote logged in machine 


Table 21-7. Values for Last Command: 
Value Command 


00h login Value Command 

Olh process termination 15h set a queue entry 

02h open file 16h control the queue 

03h close file 17h return login information 

04h create file 18h return link description 

05h create new file 19h seek on file 

06h create unique file 1Ah get server's time 

07h commit data to disk 1Bh create audit entry 

08h read file 1Ch open file in multitude of modes 
09h write file 1Dh change password 

OAh delete file 1Eb disable account 

OBh set file attributes 1Fh local server file copy 

0Ch lock byte range ---V3,0+ 

ODh unlock byte range 20h get username from account file 
OEh create subdirectory 2th translate server's logical path 
OFh remove subdirectory 22h make indirect file 

10h rename file 23h get indirect file contents 

lth find first matching file 24h get physical printer status 
12h find next matching file 25h get logical print stream info 
13h get disk free space 26h set logical print stream info 
14h get a queue entry 27h get user's account record 


INTERRUPT 21h - Function 5Fh, Subfunction B1h 
GET SHARED DIRECTORY INFORMATION 


Purpose: Determine information about a directory which may be shared with other users. 


Available on: All machines. 


Restrictions: LANtastic network software must be 


installed, 
Registers at call: Return Registers: 
AX = 5FB1h CF clear if successful 


DS:SI -> 64-byte buffer for link description 
ES:DI -> ASCIZ machine and shared directory 
name in form 'Nmachine" 


CX = access control list privilege bits for 


requesting user 
bit 5: allow attribute changing 
6: allow physical access to device 
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7: allow program execution 
8: allow file renaming 
9: allow directory deletion 
10: allow file deletion 
11: allow file/directory lookups 
12: allow directory creation 
13: allow file creation 
14: allow open for write and writing 
15; allow open for read and reading 
CF set on error 
AX = error code 
Conflicts: None known. 


INTERRUPT 21h - Function 5Fh, Subfunction B2h 
GET USERNAME FROM ACCOUNT FILE 


Purpose: Determine the permanently-stored name for the calling user. 


Available on: All machines, Restrictions: LANtastic version 3.0 or higher must be 
installed, 

Registers at call: Return Registers: 

AX = 5FB2h CF clear if successful 

BX = username entry index (0 for first) CF set on error 

DS:SI -> 16-byte buffer for username AX = error code 

ES:DI -> ASCIZ server name in form "\machine” BX = next queue entry index 


Conflicts: None known. 


INTERRUPT 21h - Function 5Fh, Subfunction B3h 


TRANSLATE PATH 

Purpose: Determine the true directory for a pathname in the presence of indirect files, 

Available on: All machines. Restrictions: LANtastic version 3.0 or higher must be 
installed, 

Registers at call: Return Registers: 

AX = SFB3h CF clear if successful ! 

DS:SI -> 128-byte buffer for ASCIZ result CF set on error ; 

ES:DI -> full ASCIZ path, including server name AX = error code | 


DX = types of translation to be performed 
bit 0: expand last component as indirect file 
bit 1: return actual path relative to server's 
physical disk 
Details: This call always expands any indirect files along the path. 
Conflicts: None known, 
See Also: Function 5Fh Subfunction B4h 


INTERRUPT 21h - Function 5Fh, Subfunction Bah 
CREATE INDIRECT FILE 


Purpose: Make a link from one part of the network filespace to another, possibly on a different machine: this is 
equivalent to symbolic links under Unix. 


Available on: All machines. Restrictions: LANtastic version 3.0 or higher must be 
installed. 

Registers at call: Return Registers: 

AX = SFB4h CF clear if successful 

DS:SI -> 128-byte buffer containing ASCIZ, CF set on error 


contents of indirect file AX = error code 
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ES:DI -> full ASCIZ path of indirect file to create, 

including machine name 
Details: The contents of the indirect file may be any valid server-relative path. 
Conflicts: None known. 


INTERRUPT 21h - Function 5Fh, Subfunction Boh 
GET INDIRECT FILE CONTENTS 


Purpose: Determine the destination of a link from one part of the network filespace to another. 


Available on: All machines, Restrictions: LANtastic version 3.0 or higher must be 
installed. 

Registers at call: Return Registers: 

AX = 5FB5h CF clear if successful 

DS:SI -> 128-byte buffer for ASCIZ indirect file CF set on error 


contents 
ES:DI -> full ASCIZ path of indirect file 
Conflicts: None known. 


INTERRUPT 21h - Function 5Fh, Subfunction COh 
GET TIME FROM SERVER 


AX = error code 


Purpose: Determine the system date and time as known to the specified server. 


Available on: All machines, 


Registers at call: 

AX = 5FCOh 

DS:SI -> time block (Table 21-8) 

ES:DI -> ASCIZ server name to get time from 
Conflicts: None known, 


Table 21-8. Format of time block: 


Offset Size Description 

00h WORD year 

02h BYTE day 

03h BYTE month 

04h BYTE minutes 

05h BYTE hour 

06h BYTE hundredths of second 
07h BYTE second 


INTERRUPT 21h - Function 5Fh, Subfunction DOh 
GET REDIRECTED PRINTER TIMEOUT 


Restrictions: LANtastic network software must be 


installed. 


Return Registers: 
CF clear if successful 
CF set on error 


AX = error code 


Purpose: Determine the duration of idleness before the printer times out. 


Available on: All machines. 


Registers at call; 
AX = SFDOh 


Conflicts: None known. 
See Also: Function 5Fh Subfunction D1h 


Restrictions: LANtastic network software must be 


installed. 

Return Registers: 
CF clear if successful 

CX = redirected printer timeout in clock ticks of 

SSms 
0000h if timeout disabled 

CF set on error 

AX = error code 
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INTERRUPT 2th - Function 5Fh, Subfunction Dih 
SET REDIRECTED PRINTER TIMEOUT 


Purpose: Specify the duration of idleness before the printer times out. 


Available on: All machines. 


Registers at call: 

AX = 5FD1h 

CX = printer timeout in clock ticks of 55ms, 
0000h to disable timeouts 

Conflicts: None known. 

See Also: Function 5Fh Subfunction DOh 


INTERRUPT 21h - Function 5Fh, Subfunction E0h 
GET DOS SERVICE VECTOR 


Restrictions: LANtastic network software must be 
installed. 
Return Registers: 
CF clear if successful 
CF set on error 
AX = error code 


Purpose: Determine address of function handling DOS calls for LANtastic. 


Available on: All machines. 


Registers at call: 
AX = 5FEOh 


Conflicts; None known. 
See Also: Function 5Fh Subfunction Elh 


INTERRUPT 2th - Function 5Fh, Subfunction Eth 
SET DOS SERVICE VECTOR 


Restrictions: LANtastic network software must be 
installed. 
Return Registers: 
CF clear if successful 
ES:BX -> current FAR service routine 
CF set on error 
AX = error code 


Purpose: Specify a new function which is to handle DOS calls. 


Available on: All machines. 


Registers at call: 
AX = 5FEIh 
ES:BX -> FAR routine to call for DOS service 


Restrictions: LANtastic network software must be 
installed. 
Return Registers: 
CF clear if successful 
CF set on error 
AX = error code 


Details: The new handler must chain to the previous handler as its first action. 


Conflicts: None known. 
See Also: Function 5Fh Subfunction EOh 


INTERRUPT 21h - Function 5Fh, Subfunction E2h 
GET MESSAGE SERVICE VECTOR 


Purpose: Determine the subroutine currently called on receipt of a message. 


Available on: All machines. 


Registers at call: 
AX = 5FE2h 


Conflicts: None known. 
See Also: Function 5Fh Subfunction E3h 


Restrictions: LANtastic network software must be 
installed. 
Return Registers: 
CF clear if successful 
ES;BX -> current FAR message service routine 
CF set on error 
AX = error code 
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INTERRUPT 21h - Function 5Fh, Subfunction E3h 
SET MESSAGE SERVICE VECTOR 


Purpose: Specify the subroutine to be called when a message is received. 


Available on: All machines. Restrictions: LANtastic network software must be 
installed. 
Registers at call: Return Registers: 
AX = 5FE3h CF clear if successful 
ES:BX -> FAR routine for processing network CF set on error 
messages AX = error code 


Details: The new handler must chain to the previous handler as its first action, on invocation, ES:BX points at the 


just-received message. 
Conflicts: None known. 
See Also: Function 5Fh Subfunction E2h 


INTERRUPT 2Ah 
Microsoft-compatible Functions 


Purpose: LANtastic supports subfunctions 00h, Olh, 04h, 05h, and O6h of the Microsoft Networks INT 2Ah 
alternate NetBIOS interface. These functions are described in chapter 27. 


INTERRUPT 2Fh - Function B8h, Subfunction 09h 


VERSION CHECK 

Purpose: Determine which version of the LANtastic software is installed. 

Available on: All machines. Restrictions: LANtastic network software must be 
installed. 

Registers at call: Return Registers: 

AX = B809h AH = major version 


AL = minor version 
Conflicts; None known. 


| 
| 
} 
| 
| 
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Banyan VINES 


The Virtual NEtwork Software package from Banyan Systems, Inc. is one of the major players in the large-network 
competition. This system was one of the first to offer full interconnection between such diverse operating systems as 
MS-DOS and UNIX, and because of this, found early acceptance by large corporations, 

For compatibility, VINES provides a number of functions from other networking software; those are merely 
pointed out here and are described in full in other chapters. 

Although the majority of the API is listed under INT 61h, the actual interrupt number used may range from 60h 
through 66h depending on system configuration. The VINES entry point is identified by the signature "BANV" im- 


mediately preceding the handler. 


INTERRUPT 21h - Functions DOh through D5h 
LOGICAL RECORD LOCKING AND UNLOCKIN 
These functions are identical to Novell NetWare’s implementation and are described in chapter 20. 





INTERRUPT 21h - Functions D8h and D9h 
RESOURCE ALLOCATION 
‘This function is identical to Novell NetWare’s implementation and is described in chapter 20. 


INTERRUPT 21h - Function DCh 
GET STATION NUMBER 
This function is identical to Novell NetWare’s implementation and is described in chapter 20, 


INTERRUPT 21h - Function E7h 
GET FILE SERVER DATE AND TIME 
This function is identical to Novell NetWare’s implementation and is described in chapter 20. 


INTERRUPT 2Fh - Function D7h, Subfunction 01h 
GET BANV INTERRUPT NUMBER 
Purpose: Determine whether Banyan VINES version 4.0 or higher is installed, and which interrupt the API is using. 


Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AX=D701h AX = 0000h installed 


BX = interrupt number (60h to 66h) 
nonzero not present 
Details: If AX is nonzero, VINES 3.x or earlier may be installed, in which case it is necessary to examine the four 
bytes preceding the handlers for INT 60h through INT 66h for the string "BANV". 
Conflicts: None known. 


INTERRUPT 60h - Function 0Ch 
GET STATION ADDRESS 


This function is identical to the 3com implementation, and is described in chapter 27. 


22-1 


22-2 Banyan VINES 


INTERRUPT 60h - Functions 11h through 13h 
SEMAPHORE LOCKING AND UNLOCKING 


Purpose: Arbitrate access to resources. These functions are identical to the 3com implementation, and are described 
in chapter 27. 

INTERRUPT 61h - Function 0001h, Subfunction 0001h 

"Sosock" - OPEN COMMUNICATIONS SOCKET 

Purpose: Establish a connection to a protocol service. 


Available on: All machines. Restrictions: Banyan VINES must be installed. 
Registers at call: Return Registers: 
AX =000Ih AX = status 
DS:DX -> communications control block 0000h successful 
(Table 22-1) 0001h service not installed 


0002h invalid service ID 

0098h resource already in use 

009Eh address family does not exist 

OO9Fh socket type does not exist 

OOAOh protocol does not exist 

OOA1h no more sockets available 

00A2h no more buffer space available 
Details: BANYAN can use any interrupt from 60h through 66h. The Banyan interrupt handler is identified by the 
string "BANV" in the four bytes immediately preceding the interrupt handler. 
Conflicts: See Chapter 1. 


Table 22-1, Format of Control Block: 


Offset Size Deseription 

00h WORD 0001h 

02h WORD pointer to argument block (Table 22-2) 
04h WORD error return code 

06h 4BYTEs reserved 


Table 22-2. Format of Argument Block: 


Offset Size Description 
00h WORD pointer to 2-byte buffer for socket identifier 
02h WORD address family 
0003h Banyan 
04h WORD socket type 
in address family 0003h 
0001h IPC socket 
0002h SPP socket 
06h WORD protocol number 
FFFFh default 
O8h WORD pointer to 16-byte buffer for socket address (Table 22-3) 
OAh WORD local port number 


0000h if service should assign transient port number 
0001h to OLFFh well-known port number (assigned by Banyan) 


Table 22-3. Format of IPC Port: 


Offset Size Description 
00h WORD address family (always 0003h for Banyan ports) 
04h 4BYTEs network number (server's serial number) 
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Table 22-3. Format of IPC port (continued) 


Offset Size Description 

06h WORD subnet number (O001h = server, 8000h-FFFEh = PC) 
08h WORD port ID (0001h-01FFh for "well-known" ports) 

OAh BYTE hop count 

OBh SBYTEs filler 


INTERRUPT 61h - Function 0001h, Subfunction 0002h 
"Sosend'" « INITIATE OUTPUT EVENT 


Purpose: Request data transmission or the establishment or termination of a virtual connection, 


Available on: All machines. Restrictions: Banyan VINES must be installed. 
Registers at call: Return Registers: 
AX =000Ih AX 5 status 
DS:DX -> communications control block 0000h successful 
(Table 22-4) 0001h service not installed 


0002h invalid service ID 
0003h-000Ah reserved for BANV interface errors 
0097h invalid socket identifier 
009Bh destination node unreachable 
009Ch message overflow 
009Dh destination socket nonexistent 
OOA2h no more buffer space 
O0A3h timeout 
QOB1h resource disconnect 
Conflicts: See Chapter 1. 


Table 22-4. Format of Control Block: 


Offset Size Description 
00h WORD 0002h 
02h WORD pointer to argument block (Table 22-5) 
04h WORD error return code 
0000h successful 
0097h invalid socket ID 


00A2h no more buffer space 
O0A3h timeout event 
OOASh resource not available 
OOAG6h internal communication failure 
OOB [h resource disconnect 
06h 4BYTEs reserved 


Table 22-5. Format of Argument Block: 


Offset Size Description 

00h WORD routine metric 

02h WORD error return code 

04h WORD socket identifier 

06h WORD pointer to send buffer (Table 22-6) 
08h WORD length of send buffer 

OAh WORD flags 


bit 0: async request’ 
I: reliable message 
3: end of user message received 
4: vectored request (if set, send buffer contains buffer 
descriptors) 


| 
i 
{ 
} 
| 
\ 
i 
\ 
\ 
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Table 22-5. Format of Argument Block (continued) 


Offset Size Description 
5: connection-specific receive 
6: change to connection-specific receive mode 


0Ch 16 BYTEs socket address (Table 22-7) 
1Ch WORD timeout value in multiples of 200ms 
1Eh WORD connection identifier 
20h WORD type of request 
0001h send message 


0002h establish a virtual connection 
0003h terminate a virtual connection 


Table 22-6. Format of Buffer Descriptor: 


Offset Size Description 

00h WORD data segment 
02h WORD buffer pointer 
04h WORD buffer length 
O6h WORD character count 


Table 22-7. Format of Socket Address for Unreliable Datagrams: 


Offset Size Description 

00h WORD 0003h address family 
02h DWORD | FFFFFFFFh network number 
06h WORD FFFFh subnet number 
08h WORD local port number 
OAh BYTE 00h-OFh hop count 

OBh S5BYTEs 0000h filler 


INTERRUPT 61h - Function 0001h, Subfunction 0003h 
"Sorec" - RECEIVE INPUT EVENT NOTIFICATION 


Purpose: Request notification on the reception of data or the establishment or termination of a virtual connection. 


Available on: All machines. Restrictions: Banyan VINES must be installed. 
Registers at call: Return Registers: 
AX =0001h AX = status 
DS:DX -> communications control block 0000h successful 
(Table 22-8) 0001h service not installed 


0002h invalid service ID 
0003h-000Ah reserved for BANV interface errors 
0097h invalid socket identifier 
00A2h no more buffer space 
00A3h timeout 
Conflicts: See Chapter 1. 


Table 22-8. Format of control block: 


Offset Size Description 
00h WORD 0003h 
02h WORD pointer to argument block (Table 22-9) 
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Table 22-8. Format of Control Block (continued) 


Ofiset Size Description 

04h WORD error return code 
0000h successful 
0097h invalid socket ID 


00A2h no more buffer space 
00A3h timeout event 
QOA5h resource not available 
OOA6h internal communication failure 
00B 1h resource disconnect 
06h 4 Bytes reserved 


Table 22-9. Format of Argument Block: 


Offset Size Description 

00h WORD character count 

02h WORD error return code 

04h WORD socket identifier 

06h WORD pointer to receive buffer (Table 22-10) 
08h WORD length of receive buffer 

OAh WORD flags 


bit 0: async request 
2: flush receive buffer on overflow 
3: end of user message received 
4: vectored request (if set, receive buffer contains buffer 
descriptors) 
5: connection-specific receive 
6: change to connection-specific receive mode 


0Ch 16 Bytes socket address 

1Ch WORD timeout value in multiples of 200ms 
1Eh WORD connection identifier 

20h WORD type of response 


Q001h message received 
0002h virtual connection established 
0003h virtual connection terminated 


Table 22-10. Format of Buffer Descriptor: 


Offset Size Description 

00h WORD data segment 
02h WORD buffer pointer 
04h WORD buffer length 
06h WORD character count 


INTERRUPT 6th - Function 0001h, Subfunction 0004h 

"Soclose" - CLOSE A SOCKET 

Purpose: Terminate the specified connection to a protocol service and all virtual connections established through 
that socket. 


Available on: All machines, Restrictions: Banyan VINES must be installed. 
Registers at call: Return Registers: 
AX =0001h AX = status 
DS:DX -> communications control block 0000h successful 
(Table 22-11) 0001h service not installed 


0002h invalid service ID 
0003h-000Ah reserved for BANV interface errors 
0097h invalid socket identifier 
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Conflicts: See Chapter 1. 


Table 22-11. Format of Control Block: 


Offset Size Description 

00h WORD 0004h 

02h WORD pointer to argument block (Table 22-12) 
04h WORD error return code 

06h 4BYTEs reserved 


Table 22-12. Format of Argument Block: 


Offset Size Description 
00h WORD socket identifier 


INTERRUPT 6th - Function 0001h, Subfunction 0005h 
"Sowait" - WAIT FOR ASYNCHRONOUS EVENT COMPLETION 


Purpose: Receive notification on the completion of outstanding send or receive requests. 


Available on: All machines. Restrictions: Banyan VINES must be installed. 
Registers at call: Return Registers: 
AX = 0001h AX = status 
DS:DX -> communications control block 0000h successful 
(Table 22-13) O00Ih service not installed 


0002h invalid service ID 
0003h-000Ah reserved for BANV interface errors 
00A2h no more buffer space available 
Q00A3h timeout event 
Details: This function returns the results for all asynchronous operations invoked from the data segment used for this 
call. 
Conflicts: See Chapter 1. 


Table 22-13. Format of Control Block: 


Offset Size Description 

00h WORD 0005h 

02h WORD pointer to argument block (Table 22-14) 
04h WORD error return code 

O6h 4BYTEs reserved 


Table 22-14, Format of Argument Block: 


Offset Size Description 
00h WORD pointer to WORD event pointer 
02h WORD timeout in multiples of 200ms, FFFFh = infinite 


INTERRUPT 61h « Function 000th, Subfunction 0008h 
"Sosession” - REGISTER APPLICATION WITH COMM SERVICE 


Purpose: Called by the application at startup to allow the communications service layer to perform initializations 
and release any resources which may have inadvertently been left in an active state. 


Available on: All machines. Restrictions: Banyan VINES must be installed. 
Registers at call: Return Registers: 
AX = 0001h AX = status 
DS:DX -> communications control block 0000h successful 
(Table 22-15) 00A2h no more buffer space available 


Conflicts: See Chapter I. 


Banyan VINES 22-7 


Table 22-15. Format of Control Block: 


Offset Size Description 
00h WORD 0008h 
02h WORD process type 
0001h transient process 
0002h resident process 
04h WORD error return code 
06h 4BYTEs reserved 


INTERRUPT 61h - Function 0001h, Subfunction 000Bh 
"Soint" - SET USER COMPLETION FUNCTION 


Purpose: Specify a handler to be invoked on the completion of an asynchronous send or receive operation. 


Available on: All machines, Restrictions: Banyan VINES must be installed. 
Registers at call: Return Registers: 
AX =0001h AX = status 
DS:DX -> communications control block 0000h successful 
(Table 22-16) 0001h service not installed 


0002h invalid service ID 
0003h-000Ah reserved for BANV interface errors 
00A2h no more buffer space available 
Details: The FAR user function is invoked with SS,DS, and ES set to the segment of the control block, and with the 
stack containing: 
DWORD return address 
WORD argument pointer (sosend or sorec argument block) 
WORD error return code 
0000h argument pointer is valid 
00A3h timeout 
Conflicts: See Chapter 1. 


Table 22-16. Format of Control Block: 


Offset Size Deseription 

00h WORD = 000Bh 

02h WORD pointer to argument block (Table 22-17) 
04h WORD error return code 

06h 2BYTEs reserved 

08h WORD user CS register 


Table 22-17. Format of Argument Block: 


Offset Size Description 

00h WORD pointer to user interrupt function 

02h WORD pointer to user stack 

04h WORD initial timeout value in multiples of 200ms, FFFFh = infinite 
INTERRUPT 61h - Function 0002h 

3270 INTERFACE 


Purpose: Provide mainframe access, The 3270/SNA and 3270/BSC options emulate a 3270 terminal on the PC and a 
3274 controller in the server node. 

Ayailable on: All machines, Restrictions: Banyan VINES must be installed. 
Registers at call: Return Registers: 

AX = 0002h AX = status 


i 
i 
: 
i 
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BH = function 
00h “pi2reset" reset 3270/SNA or 3270/BSC 
driver 
02h “pi2bse" (3270/BSC only) 
03h"pi2get” get information stored in 3270 
resident driver 
04h "pi2put" store information in 3270 resident 
driver 
05h “pi2gcur" get current screen position 
O7h "pi2sdat” send data keystroke 
08h "pi2scom" send command keystroke 
OAh "pi2field” get field info for arbitrary screen 
positions 
OFh "pi2stat" get logical unit/device status 
12h “pi2nlus" determine logical unit/device 
assignment 
13h "pi2gate" specifies comm port address to 
gateway service 
14h "pi2attach” attach a logical unit/device 
15h “pi2sdev" save logical unit/device info in 
resident driver (not supported in >3.0) 
16h "pi2gdev” get device information (not 
supported in >3.0) 
17h "pi2luinfo" get info about specific logical 
unit/device 
18h "pi2gerr" get finer error detail 
19h "pi2dhold" (3270/SNA only) holds a 3270 
device 
1Ah "pi2shut" release memory-resident module 
1Ch "pi2sprof" save profile info in res driver 
(not supported in >3.0) 
IDh “pi2gprof" get prevsly stored profile info 
(not supported in >3.0) 
DS:CX -> argument block (except BH=00h,1 Ah) 
(Tables 22-18 thru 22-31) 








0000h successful 
000Bh invalid parameter or data does not fit data 
area 
000Ch another code path currently active in 
resident driver 
Q00Dh operation currently not allowed 
0032h encountered connection disconnect error 
0033h encountered "sosend" completion error 
0034h encountered "sosend" communication error 
0035h attach request refused. extended error info 
via "pi2gerr": 
Oth resource unavailable 
02h invalid type 
03h version mismatch 
04h invalid logical unit number 
05h error during ARL processing 
06h no access for user 
007 1h encountered "sosock” error 
0072h encountered unrecognizable error 
0073h encountered "sowait" error (extended info 
via "pi2gerr") 
0074h encountered invalid type-of-request on 
“sowait" 
0075h encountered "sorec" error (extended info via 
"“pi2gerr") 
0076h encountered "sorec" completion error (ext 
info via "pi2gerr") 
0077h encountered connection request 
0078h encountered unrecognizable data 
0079h encountered unknown connection 
ID (ext info via “pi2gerr") 


Details: Either 3270/SNA or 3270/BSC interface may use Function 0002h, depending on which is loaded first. The 
other interface will then use Function OOOAh. Status codes greater than 63h indicate an inconsistency in the 
3270/SNA or 3270/BSC resident driver, which must be reloaded by the user. 

Conflicts: See Chapter 1. 


Table 22-18. Format of Argument Block for BH=03h,04h: 


Offset Size Description 
00h WORD size of data area (max 256) 
02h NBYTEs data area 


Table 22-19. Format of Argument Block for BH=05h; 


Offset Size Description 
00h WORD logical unit/device number 
02h WORD pointer to WORD buffer for cursor index 


04h WORD pointer to BYTE buffer for current field attribute 


| 
| 
| 
| 
| 
i 
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Table 22-20. Format of Argument Block for BH=07h: 


Offset Size Description 

00h WORD logical unit/device number 

02h WORD ASCII data byte 

04h WORD pointer to WORD count of characters which will need updating 


Table 22-21. Format of Argument Block for BH=08h: 


Offset Size Description 

00h WORD logical unit/device number 

02h WORD keystroke 
0000h Enter 
0001h Clear 
0002h PAI 
0003h PA2 
0004h PA3 
0005h PF1 


001Ch PF26 

001Dh CSELECT (cursor select) 
001Eh Insert 

001Fh Delete 

0020h EOField 

0021h EINPUT (erase input) 
0022h Reset 

0023h Attention 

0024h SysReq 

0025h Duplicate 

0026h Fieldmark 

0027h Home 

0028h NextLine 

0029h Tab 

002Ah BackTab 

002Bh cursor up 

002Ch cursor down 
002Dh cursor right 
002Eh cursor left 

002Fh double cursor right 
0030h double cursor left 
0031h PRINT 

0032h CANCEL 

0033h Backspace 





Table 22-22. Format of Argument Block for BH=0Ah: 


Offset Size Description 

00h WORD logical unit/device number 

02h WORD screen index 

04h WORD pointer to WORD buffer for field length 

06h WORD pointer to WORD buffer for offset in screen of field start 


Table 22-23. Format of Argument Block for BH=0Fh: 


Offset Size Description 

00h WORD logical unit/device number 

02h WORD clear mask (clear these bits of status after returning status) 
04h WORD pointer to WORD buffer for status 


bit 10: status modified 
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Table 22-23, Format of Argument Block for BH=0Fh (continued) 


Offset Size Description 
i bit 9: buffer modified 

bit 8: set cursor 

bit 5: sound alarm 

bits 0,1: size of print line for printer logical units 
00 unformatted line 
01 40-character line 
10 64-character line 
11 80-character line 


Table 22-24. Format of Argument Block for BH=12h: 


Offset Size Description 

00h WORD pointer to WORD buffer for number of logical units or devices 
02h WORD pointer to WORD buffer for version number 

04h WORD pointer to 64-byte buffer for logical unit/device list 


Table 22-25. Format of Argument Block for BH=13h: 
Offset Size Description 


00h 16 BYTEs communications port address (see Function 0001h Subfunction 0001h) 


Table 22-26. Format of Argument Block for BH=14h: 


Offset Size Description 
00h WORD logical unit/device number 
0000h attach any free device of the specified type 
02h WORD logical unit/device type 
(3270/SNA) O1h, 02h, or 03h 
(3270/BSC) 02h display 
(3270/BSC) 03h printer 
04h WORD pointer to WORD buffer for attached logical unit/device number 


Table 22-27. Format of Argument Block for BH=16h: 
Offset Size Description 


00h WORD pointer to 18-byte buffer for device block (see below). 
first WORD must be set to desired logical unit/device number 


Table 22-28. Format of Argument Block for BH=17h: 


Offset Size Description 
00h WORD logical unit/device number 
02h WORD pointer to information block in caller's DS (Table 22-33) 


Table 22-29. Format of Argument Block for BH=18h: 


Offset Size Description 
00h WORD pointer to WORD buffer for major error code 
02h WORD pointer to WORD buffer for minor error code 


Table 22-30. Format of Argument block for BH=19h: 


Offset Size Description 
00h WORD logical unit/device number 


Table 22-31. 
Offset 
00h 


Table 22-32. 


Table 22-33. 


Offset 
00h 
02h 
06h 
OAh 


Table 22-34. 


Offset 
00h 








0Sh 
06h 
07h 
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Format of Argument Block for BH=1Ch,1Dh: 


Size Description 

WORD pointer to profile block in caller's DS (Table 22-35) 

Format of Device Block, Argument Block for BH=15h: 
Size Description 


WORD logical unit/device number 
WORD logical unit/device type 

WORD display model number 

WORD numeric checking 

WORD status line 

BYTE unprotected normal field attribute 
BYTE unprotected intensified field attribute 
BYTE protected normal field attribute 
BYTE protected intensified field attribute 
WORD reserved 

WORD printer port number 


Format of Information Block: 


Size Description 

WORD device model number 

DWORD _ screen buffer pointer 

DWORD _ status line pointer (Table 22-34) 
DWORD _ reserved 


Format of Status Line: 


Size Description 
BYTE comm line status 
00h inactive 
Oth active 
BYTE activation level 
Oth physical unit activated 
02h logical unit also activated 
03h session is bound 
BYTE data traffic state 
Oh inactive 
Olh active 
BYTE screen ownership 
00h SLU->PLU sessoin owns screen 
Olh SLU->SSCP session owns screen 
BYTE keyboard status 
00h UNLOCK - ready to accept data 
Oth TIME - aid was struck 
02h SYSTEM - received response no restore 
03h FUNCTION - unavailable keyboard function 
04h INPUT - not currently used 
05h ENDFIELD - field filled in insert mode 
06h PROTECTED - attempt to enter in protected field 
07h NUMERIC - attempt to enter in numeric field 
08h PROGRAM - error in outbound data stream 
BYTE insert mode: 01h if in insert mode 
BYTE numeric: 01h if current screen buffer is numeric only 
BYTE printer status: 
00h printer not assigned 
01h printer is inactive 





i 
i 
i 
i 
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Table 22-34. Format of Status Line (continued) 


Offset Size Description 
02h printer error 
03h currently printing 


04h printer is busy 
O5h printer is very busy 
08h BYTE printer assignment 
09h BYTE maximum size of network name 
OAh NBYTEs ASCIZ network name 
BYTE maximum size of message window 


MBYTEs _ null-terminated message window 
BYTE code set: 
00h EBCDIC 
Olh ASCII 
MBYTEs_ extended attributes: 
Olh extended attributes are in effect (stored at screen+1920). 

Each extended attribute specifies bits 0,1: 00=normal, 01=blink, 
10=reverse, | 1=underscore bits 2-4: 000=default, 
001=blue, 010=red, 011=pink, 100=green, 
10l=turquoise, 110=yellow, 111=white 

BYTE extended color: 01h other than base color is in effect 


Table 22-35. Format of Profile Block: 


Offset Size Description 

00h 64BYTEs gateway service name 

40h 16 BYTEs gateway comm port address 
50h WORD primary logical unit number 
52h WORD secondary logical unit type 
54h WORD secondary logical unit number 
56h WORD printer assignment 

38h 50 BYTEs keyboard definitions filename 


INTERRUPT 61h - Function 0003h 
ASYNCHRONOUS TERMINAL EMULATION 


Purpose: Provide terminal emulation functions to allow communications with a remote host. 


Available on: All machines. Restrictions: Banyan VINES must be installed. 
Registers at call: Return Registers: 
AX = 0003h AX = status 
DS:BX -> argument block with function number 0000h successful 
(Table 22-36) Q00Bh invalid session ID 


000Ch session not active 

Q00Dh invalid request type 

OOOEh invalid parameters 

OOOFh out of heap space 

0010h timeout on send 

001 1h Banyan communications error 
0012h session not waiting for host 
0013h session is active 

0014h duplicate suspend session request 
0015h no session suspended 

0016h ring data buffer full 

0017h printer error encountered 

0018h Banyan communications error 
0019h unable to make connection 
001Ah no ring buffer specified at startup 


Conflicts: See chapter 1. 
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001Bh service is down 

001Ch invalid service name 
001Dh service is closed 

001Eh invalid connection name 


001Fh max session limit reached for service 
0020h access rights list for connection/dialout does 


not include this user 
0021h service not responding 


0022h missing telephone number 


Table 22-36. Format of Argument Block: 


Offset Size 

00h BYTE 

Oth BYTE 

~-request=00h 

02h WORD 
Offset 
00h 
02h 
06h 
08h 
OAh 
OEh 
12h 
16h 

---request=01h 

02h BYTE 


Description 
session ID (00h) 
asynchronous interface request number 
00h initialize user buffer pointer information area 
O1h send to host 
02h "control monitor" 
03h "flow control data": freeze/unfreeze display, ring buffer 
04h end active session 
05h set session parameter 
06h get session parameter 
O7h set tab settings 
O8h get tab settings 
09h refresh emulation screen 
OAh suspend session temporarily 
OBh restore previously suspended session 
OCh set state of scroll lock checking 
ODh exit emulation 
QEh interrupt on character from host 
OFh start a session 
10h start/stop printing of data received from host 
11h get file transfer parameters 
12h get connection information 
13h start/stop tracing data traffic in session 
14h interrupt on message from host 
15h reset error 


pointer to info area in caller's current DS: 


Size Description 
WORD flags 
0000h don't read interface's data buffer 
0001h read data buffer 
DWORD pointer to ring buffer 
WORD length of ring buffer 
WORD _ ring buffer offset to last byte read by caller 
DWORD pointer to WORD containing offset of last byte in ring 
buffer filled 
DWORD pointer to screen buffer 
DWORD pointer to field containing cursor position 
DWORD pointer to terminal status area (Table 22-37) 


type 
00h ASCII byte 
O1h ASCII string 
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Table 22-36. Format of Argument Block (continued) 


Offset Size Description 
02h terminal function code 
03h up arrow 
04h down arrow 
05h left arrow 
06h right arrow 
07h break 
03h NBYTEs _ type-specific info: 
Offset Size Description 
---ASCII byte 
03h BYTE _ byte to send to host 
-~ASCIHI string 
03h WORD length of string 
05h WORD pointer to string 
---terminal function code (VT52/VT 100) 
03h BYTE function code 
00h keypad 0 
Olh keypad 1 
09h keypad 9 
OAh keypad - 
OBh keypad , 
OCh keypad . 
ODh keypad ENTER 
OEh PF1 
OFh PF2 
10h PF3 
11h PF4 
~--terminal function code (IBM3101) 
03h BYTE function code 
00h PFL 
07h PF8 
08h Home 
~--request=02h 
02h BYTE display flag 


00h don't display data received from host 
Olh display data 


--request=03h 


02h 


BYTE flow control flag 
00h allow characters to be put into display or ring buffer 
O1h don't place any more characters into display or ring buffer 


---request=05h, 06h 


02h 


BYTE parameter number 
00h line speed (OOh=any, 01h=50, 02h=110, 03h=134,5, 04h=150, 05h=300, 
06h=600, 07h=1200, O8h=2400, 09h=4800, OAh=9600) 
Olh parity (OOh=none, 01h=odd, 02h=even) 
02h duplex (00h=full, 01h=half) 
03h character size (OOh=7 bits, O1h=8 bits) 
04h stop bits (OOh=1, 01h=2) 
05h XON/XOFF flow control (OOh=no, Olh=yes) 
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Table 22-36, Format of Argument Block (continued) 


Offset 


03h 


--request=07h, 


02h 


Size 


BYTE 


, 08h 
WORD 


---request=0Ah 


2 
04h 


WORD 
WORD 


--request=0Bh 


2h 
04h 


WORD 
WORD 


---request=0Ch 





2. 


BYTE 


--request=0Eh, 14h 


02h 
06h 


DWORD 
DWORD 


--request=0Fh 


02h 


---request=10h 
02h 


WORD 


Offset 
00h 
02h 
04h 


05h 
07h 


WORD 


--request=11h 


02h 


WORD 


Offset 
00h 
Olh 
02h 
03h 
07h 
O8h 


--request=12h 


02h 


WORD 

Offset 
00h 
02h 


Description 

O7h intercharacter delay in tenths of a second 

O$h interline delay in tenths of a second 

09h auto linefeed (O0h=no, 01h=yes) 

OAh filter control characters (OOh=no, Olh=yes) 

OBh terminal type (OOh=VT100,01h=glassTTY ,02h=VT52,03h=IBM3101) 

OCh auto wrap (O0h=no, 0lh=yes) 

ODh cursor shape (OOh=underscore, 01h=block) 

OEh character set (OOh=UK, O1h=US ASCII) 

OFh printer port (QOh=LPT 1, OLh=LPT2, 02h=LPT3) 
parameter value (returned for 06h) 





pointer to 80-byte buffer in caller's current DS: each byte = 00h if no tab, Oh if tab at that 
position 


size of session information to be saved 
pointer to buffer in caller's DS 


size of buffer into which session info is restored 
pointer to buffer in caller's DS 


check_scroll_lock flag 
00h off 
Oth on (display of host data stopped while ScrollLock on) 


pointer to routine to be called (0000h:0000h = don't call) 
stack pointer to use when call is made 


pointer to information area in caller's current DS: 


Size Description 
WORD length of service name 
WORD pointer to service name in caller's DS 
BYTE _ type of connection 

(00h=connection name, 01h=dialout) 
WORD length of connection name/telephone number 
WORD pointer to connection name/telephone number 


print capture flag (OOh=off, 01h=on) 


pointer to info area in caller's current DS: 


Size Description 

BYTE _ protocol flag (00h none, 01h Kermit) 
BYTE direction flag (00h send, Oh receive) 
BYTE _ length of null-terminated PC filename 
DWORD pointer to null-terminated PC filename 
BYTE _ length of null-terminated host filename 
DWORD pointer to null-terminated host filename 


pointer to info area in caller's current DS: 

Size Description 

WORD length of service name (returned) 

WORD pointer to 64-byte buffer for service name 
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Table 22-36. Format of argument block (continued) 


Offset Size 
04h 
05h 
07h 
09h 

-~-request=13h 

02h BYTE 


Description 


BYTE 


WORD 
WORD 
BYTE 


type of connection 

00h connection name 

Oih dialout 
length of connection name/telephone number 
pointer to 64-byte buffer for name/telno 
server line number being used (returned) 


trace flag (OOh=off, 01h=on) 


Table 22-37. Format of Terminal Status Area: 


Offset Size 

00h BYTE 
Oth BYTE 
02h BYTE 
03h 4 BYTEs 
07h WORD 
09h WORD 
OBh WORD 


Description 

status of session: 4Eh=oNline, 46h=oFfline, 57h=Waiting 

terminal type (0Oh=VT100, O1h=TTY, 02h=VTS52, 03h=]BM3101) 
current keypad mode (VT100,VT52 only) 


4Eh ("N") numeric mode 
41h ("A") application mode 


current state of LEDs (VT100 only) 


00h off 
Oth on 


line error count 
primary error code 


0000h no error 

0001h unable to make connection 

0002h communications error, restart session 

0003h async terminal emulation service unavailable 

0004h lost carrier 

0005h all matching lines busy 

0006h no lines defined for connection name 

0007h no dial lines available on server 

0008h no matching dial lines available 

0009h out of heap space 

O00Ah service error encountered 

000Bh timed out waiting to connect 

000Ch communications error 

000Dh communications error 

OO0Eh host wants file transferred to/from PC 

OO0Fh host software changed session parameter 

0010h host software changed tap settings 

001 1h host software changed LED indicator 

0012h host software changed display background (secondary error code 00h for 
white on black, Oth for black on white) 

0013h host software changed display option (secondary error code 00h for off, 
O1h for on) 

0014h communications error 

0015h communications error 

0016h unable to make connection 

0017h unable to make connection 


secondary error code 
INTERRUPT 61h - Function 0004h 
GET SERVER SERIAL NUMBER 


Purpose: Determine the serial number of the server providing a particular network drive. 
Available on: All machines. 


Restrictions: Banyan VINES must be installed. 





| 
| 
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Registers at call: Return Registers: 

AX = 0004h AX = status 

DS:DX -> request block (Table 22-38) 0000h server ID returned in request block 
OOOFh invalid drive 
00!5h drive not ready 


Conflicts: See chapter 1. 


Table 22-38. Format of request block: 


Offset Size Description 
00h WORD 0008h 
02h WORD drive number (O=default, 1=A, ...) 
04h 6BYTEs _ buffer for server ID 
INTERRUPT 61h - Function 0005h 
PRINTER CONTROL 
Purpose: Determine the current printer port or schedule a print job. 
Available on: All machines. Restrictions: Banyan VINES must be installed. 
Registers at call: Return Registers: 
AX =0005h AX = status 
DS:DX -> request block (Table 22-39) 0000h successful 
0001h network software not installed or 
incompatible 


Conflicts: See Chapter |. 


Table 22-39. Format of request block: 


Offset Size Description 

00h WORD function 
0201h "endspool" all data for a print job has been sent 
0205h "getactive" get currently active printer port 


02h WORD number of active port (1-3) 

04h WORD unknown. (0 for func 0201h, 3 for func 0205h) 

06h WORD = 0000h 

INTERRUPT 61h - Function 0007h, Subfunction 0002h 

GET PORTS FOR A SERVICE 

Purpose: Determine which ports may be used to communicate with the specified service. 

Available on: Ali machines. Restrictions: Banyan VINES must be installed. 
Registers at call: Return Registers: 

AX = 0007h AX = status 

BX = 0002h 0000h successful 

DS:DX -> StreetTalk service name 0001h PC network software not installed or 
DS:DI -> port record block (Table 22-40) incompatible 


03E9h incorrect name syntax 

03EAh organization name too long 

03EBh group name too long 

03ECh item name too long 

03EDh StreetTalk name too long 

03F3h organization not found 

03F4h group not found 

03F5h StreetTalk name not found 

03F8h not a StreetTalk name 

040Dh appropriate StreetTalk name unavailable 
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Conflicts: See chapter 1. 


Table 22-40. Format of Port Record Block: 


Offset Size Description 
00h WORD number of 17-byte elements 
02h 17 BYTEs element (byte 00h = input port type, bytes 01h-10h = port) 


(see Function 0001h Subfunction 0001h for port format) 
INTERRUPT 6th - Function 0007h, Subfunction 0004h 
SET PORTS FOR SERVICE 


Purpose: Specify which ports may be used to communicate with the specified service, This call is used only by the 
PC-based services. 


Available on: All machines. Restrictions: Banyan VINES must be installed. 

Registers at call: Return Registers: 

AX = 0007h AX = status 

BX =0004h 0000h successful 

DS:DX -> StreetTalk name of service 0001h PC network software not installed or 
incompatible 

DS:DI -> port record block (Table 22-41) O3E9h incorrect name syntax 


03EAh organization name too long 
03EBh group name too long 
03ECh item name too long 
03EDh StreetTalk name too long 
03F3h organization not found 
03F4h group not found 
O3F5h StreetTalk name not found 
03F8h not a StreetTalk name 
0409h modify access denied 
040Dh appropriate StreetTalk name unavailable 
Conflicts: See chapter 1. 


Table 22-41. Format of Port Record Block: 


Offset Size Description 
00h WORD number of 17-byte elements 
02h 17 BYTEs element: byte 00h = input port type, 01h-10h = port (see Function 000Lh Subfunction 


000th for port format) 
INTERRUPT 61h - Function 0007h, Subfunction 0005h 


GET USER NAME 

Purpose: Determine the StreetTalk name of the user logged into the caller's machine. 

Available on: All machines. Restrictions: Banyan VINES must be installed. 
Registers at call: Return Registers: 

AX = 0007h AX = status 

BX =0005h 0000h successful 

DS:DX -> 64-byte buffer for user's StreetTalk name 0001h network software not installed or 


incompatible 
Details: If no user logged in, the first byte of the returned name will be 0Oh. 
Conflicts: See Chapter 1. 


INTERRUPT 61h - Function 0007h, Subfunction 0006h 
TRANSLATE ERROR INTO ASCII STRING 


Purpose: Retrieve a printable string corresponding to the specified error code. 
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Available on: All machines. Restrictions: Banyan VINES must be installed. 


Registers at call: Return Registers: 

AX = 0007h AX = status 

BX = 0006h 0000h successful 

SI = error code (>100) 0001h network software not installed or 
DS:DX -> 80-byte buffer for error text incompatible 


Conflicts: See chapter 1. 


INTERRUPT 61h - Function 0007h, Subfunction 0007h 
VERIFY EXISTENCE OF NAME AND RETURN CANONICAL FORM 


Purpose: Determine whether the specified name exists, and if so, its full form with the correct case. 


Available on: All machines. Restrictions: Banyan VINES must be installed. 
Registers at call: Return Registers: 

AX = 0007h AX = status 

BX = 0007h 0000h successful 


000th PC network software not installed or 
incompatible 

03E9h incorrect name syntax 

O3EAh organization name too long 

03EBh group name too long 

03ECh item name too long 

O3EDh StreetTalk name too long 

03F3h organization not found 

03F4h group not found 

03F5h StreetTalk name not found 

03F8h not a StreetTalk name 

040Dh appropriate StreetTalk name unavailable 


DS:DX -> NiceName block (Table 22-42) 


Conflicts: See Chapter I. 
See Also: Function 0007h Subfunction 0008h 


Table 22-42, Format of NiceName block: 


Offset Size Description 
00h WORD type of name 
0064h organization 
O0C8h group 
012Ch item 
02h WORD pointer to ASCIZ input name 
04h WORD pointer to 64-byte buffer for output name 


INTERRUPT 61h - Function 0007h, Subfunction 0008h 
ENUMERATE SireetTalk NAMES 


Purpose: Retrieve a list of all names matching the specified criteria. 


Available on: All machines. Restrictions: Banyan VINES must be installed. 
Registers at call: Return Registers: 

AX = 0007h AX = status 

BX = 0008h 0000h successful 


041 1h all matching names have been returned 

0412h some groups unavailable, all available 
matches returned 

Details: Each program using this call should continue until a nonzero status is returned; otherwise, some resources 

will not be freed for several hours. 

Conflicts: See Chapter |. 

See Also: Function 0007h Subfunction 0007h 


DS:DX -> enumerate block (Table 22-43) 
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Table 22-43. 


Offset 
00h 
02h 
04h 


06h 


08h 
OAh 
0Ch 
OEh 


Table 22-44. 


Offset 
00h 


02h 
04h 
06h 


Table 22-45, 


Value 
0002h 
0003h 
0004h 
0005h 
0006h 
0008h 
0009h 
000Ah 
000Ch 
000Dh 


Format of Enumerate Block: 


Size Description 
WORD return code 
WORD pointer to pattern string 
WORD enumerate type 
0064h organization 
00C8h group 
012Ch item 
WORD enumerate class 
0000h unspecified (retum all matching items) 
0001h user names 
0002h service names 
0003h list names 
0004h nicknames 
WORD pointer to category criteria block (Table 22-44) or 0 
WORD pointer to array of 64-byte returned names 
WORD number of names returned 
6BYTEs _ reserved for subsequent enumerated calls (set to zeros on first call) 


Format of Category Criteria Block: 


Size Description 
WORD exclude flag 
0000h return only items with the specified categories 
000th return all items except those with the given categories 
WORD number of categories 
WORD category | value (Table 22-45) 
WORD category 2 value 


Values for Common Service Categories: 


Service Category 
file service 

print service 

mail service 
StreetTalk 

time service 
semaphore service 
3270/SNA service 
asynchronous terminal emulation service 
NETBIOS service 
PC-based service 


INTERRUPT 61h - Function 0008h, Subfunction 0002h 
POST MESSAGE ON LOCAL DISPLAY 


Purpose: Display a message on the 25th line of the PC's display until a timeout or the user presses 4X. 
Available on: All machines. Restrictions: Banyan VINES must be installed. 


Banyan VINES 22-21 


Registers at call: Return Registers: 
AX = 0008h AX = status 
BX = 0002h 0000h successful 
CX = flags 000Bh message display function currently busy 
bit 0: message will remain on screen until user 000Ch message queue full 
presses 4X 
bit 1: ring bell after displaying message 
bit 2: blink 


DS:DX -> ASCIZ string to display (only the first 80 

characters are used) 
Details: This function queues up to three messages to be displayed on the bottom line. 
Conflicts: See Chapter |. 


INTERRUPT 61h - Function 0008h, Subfunction 0003h 
INTERCEPT VINES 25th-LINE MESSAGES AT LOCAL PC 


Purpose: Specify a routine to process messages sent to the 25th line by VINES. 





Available on: All machines. Restrictions: Banyan VINES must be installed. 

Registers at call: Return Registers: 

AX = 0008h AX = status 

BX =0003h 0000h successful 

DS:DX -> request block (Table 22-46) 0001h network software not installed or 
incompatible 


Details: The message handler should not call BIOS or DOS functions, and should either call the next handler or 
simply return. To stop intercepting messages, the routine should set the previous and next request blocks to point at 
each other. 

Conflicts: See chapter 1. 


Table 22-46. Format of Request Block: 


Offset Size + Description 

00h DWORD pointer to user-written message handler 

04h DWORD pointer to next request block (filled in by VINES) 

08h DWORD pointer to previous request block (filled in by VINES) 

0Ch DWORD _ pointer to message storage area (Table 22-47) (filled by VINES) 


Table 22-47. Format of Message Storage Area: 


Offset Size Description 

00h 16 BYTEs IPC port of message sender (see Function 0001h Subfunction 0001h) 
10h BYTE message flags 

1th WORD reserved 

13h BYTE length of message 

14h 80 BYTEs message text 


INTERRUPT 61h - Function 000Ah 
SECONDARY 3270 INTERFACE 


Purpose: Provide mainframe access. The 3270/SNA and 3270/BSC options emulate a 3270 terminal on the PC and a 
3274 controller in the server node. 


Available on: All machines. Restrictions: Banyan VINES must be installed. 
Registers at call: Return Registers: 
AX = 000Ah Same as for Function 0002h 


Details: Either 3270/SNA or 3270/BSC interface will use Function 000Ah, depending on which is loaded second. 
The first interface loaded will use Function 0002h. 
Conflicts: See Chapter If. 


22-22 Banyan VINES 


See Also: Function 0002h 
INTERRUPT 61h - Function 01h 


CHECK SERVICE 
Purpose: Determine whether the specified service is installed and available. 
Available on: All machines. Restrictions: Banyan VINES must be installed. 
Registers at call: Return Registers: 
AH = 01h AX = status 
AL = service ID 0000h installed 
01h communications 0001h not installed 
02h primary 3270 emulation 0002h invalid ID 
03h asynchronous terminal emulation 
04h file deflection 
07h StreetTalk 


08h environment 

OAh secondary 3270 emulation 

OBh semaphore service 

OCh 3270 emulation active status 

ODh 3270 keyboard interrupt simulator 
Conflicts: See chapter 1. 


INTERRUPT 67h - Function 02h 


GET REVISION NUMBER 

Purpose: Determine the current revision of the Banyan software which is installed. 

Available on: All machines. Restrictions: Banyan VINES must be installed. 
Registers at call: Return Registers: 

AH = 02h AX = 0000h installed 

DS:DX -> 2-byte buffer for result DS:DX buffer contains revision number as 10000d * 


major_ver + 100d * minor_ver + patch_revision 
Conflicts: See Chapter 1. 








10Net 


The 10NetPlus LAN Operating System from Digital Communications Associates, Inc, (the Crosstalk and IRMA 
folks) is, like Lantastic, an MS-DOS-based network rather than a DOS emulator. It uses SMB protocols, and inter- 


faces to NetBIOS and OSDI transport software to communicate between stations. 


INTERRUPT 60h - Functions 11h through 13h 
SEMAPHORE LOCKING AND UNLOCKING 


Purpose: Arbitrate access to resources. These functions are identical to the 3com implementation, and are described 


in chapter 27. 

INTERRUPT 6Fh - Function 00h 

LOGIN 

Purpose: Authenticate user to network server. 

Available on: All machines. Restrictions: 10Net software must be installed. 
Registers at call: Return Registers: 

AH = 00h CL = security level 

DS:DX - > login record (Table 23-1) AX = status (see Table 23-2) 


Conflicts: HP ES-12 Extended BIOS (chapter 4). 
See Also: Function 01h 


Table 23-1. Format of Login Record: 


Offset Size Description 

00h 8BYTEs username 

08h 8BYTEs password 

10h 12BYTEs name of SuperStation 


Table 23-2. 10Net Status Codes 


Note: One of our sources indicates that the error codes are FFxxh, another that they are xxFFh. 
We are unsure which source is correct. 


Code Status Code Status 
0000h successful I7FFh record lock time out error 
OLFFh time out on response 18FFh currently spooling to named device 
O2FFh network (hardware) error I9FFh dropped receive message (throttle) 
O3FFh invalid password LAFFh open sharing violation 
O4FFh local resource not available IBFFh no more tuf entries left 
OSFFh server resource not available ICFFh not file owner on open 
O6FFh already logged in under different name IDFFh read security not passed 
O7FFh login security failure (node) LEFFh write security not passed 
O8FFh not logged in LFFFh group security not passed 
O9FFh position calc error 20FFh security file failure 
OAFFh receive subfunction not = send 21FFh activity file failure 
subfunction (Le. read, write) 22FFh spool control file failure 
OBFFh request function not in range 23FFh device not mounted (spooling) 
OCFFh no more server file handle entries left 24FFh spool file has not been terminated 
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Table 23-2. 10Net Status Codes (continued) 


Code Status Code Status 
ODFFh no more Shared file table entries left 25FFh device not mounted or is not being shared 
OEFFh no more user file handle entries left 26FFh duplicate node ID 
OFFFh chat permit not on 27FFh file not found error 
10OFFh not @ server on request 28FFh no more files 
LILFFh no transporter board error 29FFh unknown internal system error 
12FFh time out on send 2AFFh print queue is full or corrupted 
I3FFh item not found (spool item not on 2BFFh invalid function 
queue} 2CFFh invalid handle 
14FFh DOS access incompatible 2DFFh too many files opened 
ISFFh record already locked 2EFFh path not found 
16FFh invalid parameter 2FFFh named file is active 
INTERRUPT 6Fh - Function 01h 
LOGOFF 
Purpose: Terminate a login session with the specified server, 
Available on: All machines. Restrictions: 10Net software must be installed. 
Registers at call: Return Registers: 
AH = 01h CX = number of files closed 
DS:DX -> superstation ID or nulls (12 bytes) AX = status (see Table 23-2) 


FFO8h superstation ID not already logged in 
Conflicts: HP ES-12 Extended BIOS (chapter 4). 
See Also: Function 00h 


INTERRUPT 6Fh - Function 02h 


STATUS OF NODE 

Purpose: Determine the type and state of a machine on the network, 

Available on: All machines. Restrictions: 10Net software must be installed, 
Registers at call: Return Registers: 

AH = 02h CF clear if successful 

DS:DX -> 512-byte status record (Table 23-3) CF set on error 


AX = error code (see Table 23-2) 


Table 23-3. Format of Node Status Record: 


Offset Size Description 
00h 8 BYTEs user name (0 if none) 
08h BYTE station type 


00h workstation 

Oh superstation 

02h gateway station 

03h gateway active 

04h logged into multiple superstations 
O5h reserved 


09h 24 BYTEs list of superstations logged into more than one superstation 
21h 12 BYTEs node ID 
2Dh WORD message count for this station (send for user node, receive for superstations) 
---for superstations only 
2Fh WORD drives allocated (bit O=A:, bit 1=B:,...) 
31h BYTE user service flag 
bit 7: gate 


bit 6: print permit on 

bit 4: SUBMIT is on 

bit 3: mail waiting for node 
bit 2: calendar waiting for you 


10Net 23-3 


Table 23-3. Format of Node Status Record ( continued) 


Offset Size Description 
bit 1: news waiting for you 
bit 0: mail waiting for you 


32h BYTE printers allocated (bit O=LPTI....) 

33h BYTE number of unprinted spool files 

34h BYTE number of opened files 

35h BYTE number of logged on nodes 

36h BYTE primary drive (1=A:) 

37h BYTE reserved 

38h NBYTEs _ list of logged on node IDs (each 12 bytes, max 37 IDs) 
1F4h 3BYTEs time: sec/min/hrs 

IF7h 3BYTEs date: day/mon/year-1980 


INTERRUPT 6Fh - Function 03h 
GET ADDRESS OF CONFIGURATION TABLE 


Purpose: Determine the location of a table specifying the network configuration and statistics. 


Available on: All machines. Restrictions: 10Net software must be installed. 
Registers at call: Return Registers: 
AH = 03h ES:BX -> configuration table (Table 23-4) 


DS:DI -> node ID (optional) 
Conflicts: HP ES-12 Extended BIOS (chapter 4). 
See Also: Function 13h 


Table 23-4. Format of Configuration Table: 


Offset Size Description 

-41 WORD local device table address 
-39 WORD extended network error mapping table address 
-37 WORD shared device table address 
-35 WORD mounted device table address 
33 BYTE receive buffer counter 

-32 BYTE collect buffer counter 

-31 WORD TUF address 

+29 BYTE enable flag 

+28 BYTE FCB keep flag 

27 WORD reserved 

--up to here, 10Net v3.34 

-25 WORD count of dropped Send6F 
-23 WORD buffer start address 

-21 WORD comm driver base address 
19 WORD send/receive retry count 

-17 BYTE number of 550ms loops before timeout 
-16 WORD UFH address 

-14 WORD CDIR address 

-12 WORD LTAB address 

-10 WORD SFH address 

-8 WORD FTAB address 

-6 WORD RLTAB address 

4 WORD SMI address 

2 WORD NTAB address 

00h WORD __ address of first CT_DRV 
02h BYTE number of DRV entries 

03h 8BYTEs login name 

OBh 12 BYTEs node ID (blank-padded) 

17h 6BYTEs node address 


1Dh BYTE flag 
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Table 23-4, Format of Configuration Table (continued) 


Offset Size Description 

1Eh BYTE CT_CFLG (chat permit) 
bit L: sound bell 
bit 0: CHAT permit 

1Fh BYTE CT_PSFLG 
bit 5: PRINT permit 
bit 4: KB initiated 
bit 3: CHAT called FOXPTRM 
bit 2: SUBMIT active 
bit 1: SUBMIT received 
bit 0: SUBMIT permit 








20 BYTE in 10Net flag 

21h WORD receive message count 

23h WORD send message count 

25) WORD retry count 

27h WORD failed count 

29h WORD driver errors 

2B WORD dropped responses/CHATs 

2Dh 9BYTEs LIST ID/NTAB address (3 entries--LPT 1-3) 
36h G6BYTEs AUX ID/NTAB address (2 entries--COM1-2) 
3Ch BYTE active CB channel 

3D) BYTE received INT 6Fh messages on queue 

3Eh 9 BYTEs activity counters for channels 1-9 

---beyond here, 10Net v3.34 

47h BYTE bit 0 = RS232 gate, | = Send6F gate (user set) 
48h DWORD pointer into gate (user set) 

4Ch DWORD pointer into 1ONet send 

50h N WORDs addresses of timer blocks 


INTERRUPT 6Fh - Function 04h 
SEND 


Purpose: Transmit data over the network. 


Available on: All machines. Restrictions: 10Net software must be installed. 
Registers at call: Return Registers: 

AH = 04h CF set on error 

DS:BX -> send data description record (Table 23-5) AX = error code (see Table 23-2) 

DS:DX -> data (max 1024 bytes) CF clear if successful 


Conflicts: HP ES-12 Extended BIOS (chapter 4). 
See Also: Function 05h 


Table 23-5. Format of Send Data Description Record: 


Offset Size Description 
00h 12 BYTEs receiving node's ID: 
if the first byte has its high-order bit set, the message is directed to the CT_RGATE vector 
at the receiver 
if the second byte is OOh, the first byte is taken as a CB channel number and the message is 
delivered to all nodes on the same channel 


0Ch WORD length of data at DX 
INTERRUPT 6Fh - Function 05h 
RECEIVE 


Purpose: Await data from the network. 
Available on: All machines. Restrictions: 10Net software must be installed. 
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Registers at call: Return Registers: 


AH = 05h CF set on error 
CX = number of seconds before timeout AX = error code (see Table 23-2) 
DS:DX -> receive buffer (Table 23-6) CF clear if successful 


AH = FEh if dequeued message is a CB message 


Conflicts: HP ES-12 Extended BIOS (chapter 4). 
See Also: Function 04h 


Table 23-6. Format of Receive Buffer: 


Offset Size Description 

00h 12 BYTEs sending node's ID 

0Ch WORD length of message 

OEh NBYTEs message (maximum 1024 bytes) 

INTERRUPT 6Fh - Function 07h 

LOCK HANDLE 

Purpose: Request exclusive access to a portion of the file corresponding to the indicated file handle. 
Available on: All machines. Restrictions: 10Net software must be installed. 
Registers at call: Return Registers: 

AH = 07h CF set on error 

BX = file handle AX = error code (see also Table 23-2) 
CX:DX = starting offset in file 0002h file not found 

SI = record length CF clear if successful 


Conflicts: HP ES-12 Extended BIOS (chapter 4). 
See Also: Function 08h, DOS INT 21h Function 5Ch (chapter 8) 


INTERRUPT 6Fh - Function 08h 
UNLOCK HANDLE 


Purpose: Allow others to access the file corresponding to the indicated file handle. 


Available on: All machines. Restrictions: 10Net software must be installed. 
Registers at call: Return Registers: 
AH = 08h CF set on error 
BX = file handle AX = error code (see also Table 23-2) 
AL = mode 0002h file not found 
00h unlock all CF clear if successful 


Oth unlock record at CX:DX 
Conflicts: HP ES-12 Extended BIOS (chapter 4). 
See Also: Function 07h, DOS INT 21h Function SCh (chapter 8) 


INTERRUPT 6Fh - Function 09h 
SUBMIT 


Purpose: Specify a command to be executed on another machine. 


Available on: All machines. Restrictions: 10Net software must be installed. 
Registers at call: Return Registers: n/a 
AH = 09h 


DS:BX -> submit record (Table 23-7) 


Table 23-7. Format of Submit Record: 


Offset Size Description 
00h 12 BYTEs destination node ID (must be logged in) 
0Ch WORD length+2 of following ‘command line’ text 


OEh NBYTEs command line text (<=100 bytes), system adds CR 
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INTERRUPT 6Fh - Function 0Ah 
CHAT 


Purpose: Send a message to another user or all users on the network. 

Available on: All machines. Restrictions: 10Net software must be installed. 
Registers at call: AH = 0Ah Return Registers: n/a 

DS:BX -> control parameters (Table 23-8) 

DS:DX -> chat message (Table 23-9) 


Table 23-8. Format of Chat Control Parameters: 


Offset Size Description 

00h SBYTEs sender ID, defaults to node's userID if nulls 
08h 8BYTEs destination user ID, ‘EVERYONE’ may be used 
10h 12 BYTEs destination node ID 


Table 23-9. Format of Chat Message: 


Offset Size Description 
00h WORD length+2 of following text 
02h NBYTEs _ text, max 101 bytes 


INTERRUPT 6Fh - Function 0Bh 
LOCK SEMAPHORE, RETURN IMMEDIATELY 


Purpose: Attempt to gain exclusive access to the specified resource. 


Available on: All machines. Restrictions: 10Net software must be installed. 
Registers at call: Return Registers: 

AH = OBh AL = status 

AL = drive number or 0 00h successful 

ES:SI = Ethernet address or 0 Olh semaphore currently locked 

DS:BX -> 31-byte ASCIZ semaphore name 02h server not responding 


03h invalid semaphore name 

04h semaphore list is full 

05h invalid drive ID 

06h invalid Ethernet address 

07h not logged in 

08h write to network failed 

09h semaphore already logged in this CPU 
Details: This call is the same as INT 60h Function 12h. 
Conflicts: HP ES-12 Extended BIOS (chapter 4). 
See Also: Function 0Ch, INT 60h Function 12h 


INTERRUPT 6Fh - Function 0Ch 


UNLOCK SEMAPHORE 

Purpose: Indicate that the specified resource is once again available. 

Available on: All machines. Restrictions: 10Net software must be installed. 
Registers at call: Return Registers: 

AH =0Ch AL = status (see also Function OBh) 

AL = drive number or 0 Oh semaphore not locked 


ES:SI = Ethernet address or 0 

DS:BX -> 31-byte ASCIZ semaphore name 

Details: This call is the same as INT 60h Function 13h. 
Conflicts: HP ES-12 Extended BIOS (chapter 4). 

See Also: Function OBh, INT 60h Function 13h 
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INTERRUPT 6Fh - Function 0Dh 
WHO 


Purpose: Determine the names of the machines on the network and the users currently logged into them. 


Available on: All machines. Restrictions: |ONet software must be installed. 
Registers at call: Return Registers: 
AH =0Dh CL = number of records returned (responding stations) 


AL = type code 
O1h return superstations only 
02h return non-superstations only 
otherwise return all 
CX = length of data 
DS;DX -> array of records to be filled (Table 23- 
10) 
Conflicts: HP ES-12 Extended BIOS (chapter 4). 


Table 23-10, Format of Station Record: 


Offset Size Description 
00h 12 BYTEs node ID 
0Ch BYTE flags 


bit | = workstation 
bit 2 = superstation 
bit 3 = xgate 

bit 4 = active gate 


if AL = 01h 
O0Dh BYTE version number 
WORD level number of 10Net software in responding node 
--if AL = 02h 
ODh 8BYTEs user ID 
15h BYTE version number 
16h WORD level number 
INTERRUPT 6Fh - Function 0Eh 
SPOOL/PRINT 
Purpose: Control the print spooler. 
Available on: All machines. Restrictions: 10Net software must be installed. 
Registers at call: Return Registers: 
AH = 0Eh CF set on error 


AX = error code (see also Table 23-2) 
FF17h device not mounted 
FFI8h already spooling to named device 
CF clear if successful 


DS:DX -> spool/print record (Table 23-11) 


Conflicts: HP ES-12 Extended BIOS (chapter 4). 


Table 23-1], Format of SpoollPrint Record: 


Offset Size Description 

00h WORD operation code 
00h initiate spool 
O1h abort print 
02h close spool 
03h delete spool 
04h print 
OSh get report info 
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Table 23-11. Format of SpoollPrint Record (continued) 


Offset Size Description 
06h set chat template 
O7h queue 
08h return queue 
09h queue non-spooled file for printing 


02h 11 BYTEs file name in FCB format 
-~if operation code = 00h or 06h 
ODh BYTE notification 


bit 7: queue to top 

bit 6: do ID page 

bit 5: no form feed 

bit 4: reserved 

bit 3: explicity queuing only 

bit 2: notify at print completion 
bit 1: notify server operator/reply 
bit 0: notify at print start 


OEh BYTE days to keep (FFh=forever) 
OFh BYTE bits 0,1: device (1=LPT1) 

bits 4-7: remote drive to store spool file (1=A,...) 
10h WORD length of following data area 
12h NBYTEs up to 64 bytes of description 
---if operation code = 03h 
ODh 8BYTEs user ID to associate with filename 
--if operation code = 04h 
ODh WORD block number 
OFh 8BYTEs user ID to associate with filename 
---if operation code = 05h 
ODh BYTE RRN to start retrieve 
OEh BYTE bits 0,1: local print device (LPTx) 

bit 3: if set, return entries for all users 
OFh WORD length of following area 
ith NBYTEs up to 1500 bytes to receive $SCNTL records returned 
-~-if operation code = 07h 
ODh BYTE queue number 
OEh BYTE bits 0,1: local print device (LPT x) 
OFh WORD number of bytes of test print to be done 
Ih BYTE code: 01h print device 

02h test print count 
03h prn 


---if operation code = 08h 
ODh BYTE queue location or $SCNTL location to start access 
returns next item for access: 
00h-7Fh queued items 
80h-FEh non-queued, non-printed items 


FFh no more items 
OEh WORD unused 
10h WORD length of following area 
12h NBYTEs up to 64 bytes to receive $SCNTL records (Table 23-12) 
---if operation code = 09h 
ODh 3 BYTEs unused 


10h NBYTEs _ path to non-spooled file to be queued for printing 
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Table 23-12. Format of $SCNTL Record: 


Oftset Size Description 

00h 8BYTEs user ID 

08h 11 BYTEs filename in FCB format 
13h 6BYTEs node ID 

19h 3BYTEs creation date 

1Ch BYTE flags 


bit 7: queue to top 

; do ID page 

:no form feed at end 

: reserved 

bit 3: explicit queueing only 

bit 2: notify at completion 

bit 1: notify server operator/reply 
bit O: notify at start 






1Dh BYTE retention time in days 

1Eh BYTE printing device (LPTx) 

1Fh 3BYTEs date last printed (0 = never) 
22h BYTE device containing spoolfile 
23h WORD bytes to print for test print 
25h WORD biock number to start print 
27h BYTE reserved 

INTERRUPT 6Fh - Function 10h 
ATTACH/DETACH PRINTER 


Purpose: Specify whether to spool data to the printer. 
Available on: All machines. 
Registers at call: 
AH = 10h 
AL = subfunction 
00h initiate spooling if LPT is mounted 
Oh terminate spooling if LPT1 is mounted 
Conflicts: HP ES-12 Extended BIOS (chapter 4). 
See Also: DOS INT 21h Function SDh Subfunction 08h (chapter 8) 


INTERRUPT 6Fh - Function 11h 
LOCK FCB 


Return Registers: n/a 


Restrictions: 10Net software must be installed. 


Purpose: Request exclusive access to a portion of the file corresponding to the specified File Control Block. 


Available on: All machines. 
Registers at call: 
AH = 11h 
AL = mode 
O1h sequential 
02h random 
03h random block 
CX = number of records 
DS:DX -> FCB (see DOS INT 21h Function OFh, 
chapter 8) 
Conflicts: HP ES-12 Extended BIOS (chapter 4). 
See Also: Function 12h 


Restrictions: |ONet software must be installed. 


Return Registers: 
CF set on error 
AX = etror code (see also Table 23-2) 
0002h file not found 
CF clear if successful 
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INTERRUPT 6Fh - Function 12h 


UNLOCK FCB 
Purpose: Allow others to access the indicated portion of the file corresponding to the File Control Block. 
Available on: All machines. Restrictions: 10Net software must be installed, 
Registers at call: Return Registers: 
AH = 12h CF set on error 
AL = mode AX = error code (see also Table 23-2) 

00h sequential 0002h file not found 

Olh random CF clear if successful 

02h random block. 


CX = number of records 

DS:DX -> FCB (see DOS INT 21h Function OFh, 
chapter 8) 

Conflicts: HP ES-12 Extended BIOS (chapter 4). 

See Also: Function 11h 


INTERRUPT 6Fh - Function 13h 
GET REMOTE CONFIGURATION TABLE ADDRESS 


Purpose: Determine the address of the configuration table for another machine on the network. 


Available on: All machines. Restrictions: 10Net version 3.3 or higher must be 
installed. 

Registers at call: Return Registers: 

AH = 13h CF set on error 

DS:DX -> node ID, 12 bytes blank-padded AX = error code (see Table 23-2) 


CF clear if successful 
ES:BX = configuration table address on the given 


machine 

Conflicts: HP ES-12 Extended BIOS (chapter 4), 

See Also: Function 03h 

INTERRUPT 6Fh - Function 14h 

GET REMOTE MEMORY 

Purpose: Make a copy of a portion of another machine's memory, 

Available on: Ali machines. Restrictions: 10Net version 3.3 or higher must be 
installed. 

Registers at call: Return Registers: 

AH = 14h CF set on error 

BX:SI = address of remote memory AX = error code (see Table 23-2) 

CX = length (<=1024 bytes) CF clear if successful 

DS:DX -> node ID, 12 bytes blank-padded CX = amount of memory copied to DS:SI 

DS:DI -> area to receive remote memory image 

INTERRUPT 6Fh - Function 15h, Subfunction 01h 

GET SHARED DEVICE ENTRY 

Purpose: Determine the name and attributes of a device shared with other machines on the network. 

Available on: All machines. Restrictions: 10Net version 3.3 or higher must be 
installed, 

Registers at call: Return Registers: 

AX = 150th CF set on error 

BX = zero-based index AX = error code (see Table 23-2) 


DS:SI -> node ID, 12 bytes blank-padded CF clear if successful 
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ES:DI -> 85-byte buffer for shared device table ES:DI buffer contains shared device table entry of 
entry (Table 23-13) BXth device: 

Conflicts: HP ES-12 Extended BIOS (chapter 4), 

See Also: Function 15h Subfunctions 02h and 03h 


Table 23-13. Format of Shared Device Table Entry: 


Offset Size Description 

00h 8BYTEs device 

08h 8BYTEs alias 

10h 64BYTEs path 

50h 8BYTEs password 

58h BYTE access 

59h 4BYTEs mask 

INTERRUPT 6Fh - Function 15h, Subfunction 02h 

SET SHARED DEVICE ENTRY 

Purpose: Modify the attributes of a device shared with other machines on the network, 

Available on: All machines. Restrictions: 10Net version 3.3 or higher must be 
installed. 

Registers at call: Return Registers: 

AX = 1502h CF set on error 

DS:SI -> node ID, 12 bytes blank-padded AX = error code (see Table 23-2) 

ES:DI -> valid shared device table entry (see CF clear if successful 

Table 23-13) 

Conflicts: HP ES-12 Extended BIOS (chapter 4). 

See Also: Function 15h Subfunctions 01h and 03h 

INTERRUPT 6Fh - Function 15h, Subfunction 03h 

DELETE SHARED DEVICE ENTRY 

Purpose: Stop sharing a device with other machines on the network, 

Available on: All machines. Restrictions: 10Net version 3.3 or higher must be 
installed. 

Registers at call: Return Registers: 

AX = 1503h CF set on error 

BX = zero-based index AX = error code (see Table 23-2) 

DS:SI -> node ID, 12 bytes blank-padded CF clear if successful 

Conflicts: HP ES-12 Extended BIOS (chapter 4). 

See Also: Function 15h Subfunctions 01h and 02h 

INTERRUPT 6Fh - Function 17h 

MOUNT 

Purpose: Associate a remote drive or device with a local drive number, 

Available on: All machines. Restrictions: !0Net version 3.3 or higher must be 
installed. 

Registers at call: Return Registers: 

AH = 17h CF set on error 

AL = local drive number (0=A:) AX = error code (see Table 23-2) 

BL = remote drive letter CF clear if successful 


or'1'..'3' for LPTn 

or '4' or '5' for COMx 
DS:DX -> node ID, 12 bytes blank-padded 
Conflicts: HP ES-!2 Extended BIOS (chapter 4). 
See Also: Function 18h 
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INTERRUPT 6Fh - Function 18h 
UNMOUNT 


Purpose: Terminate the association between a local drive number and a remote drive or device, 


Available on: All machines. 


Registers at call: 
AH = 18h 
AL = local drive number (0=A:) 
BL = type 
00h disk 
Olh-03h = =LPTn 
04h,05h = COMx 


Conflicts: HP ES-12 Extended BIOS (chapter 4). 


See Also: Function 17h 


Restrictions: 10Net version 3.3 or higher must be 
installed. 
Return Registers: 
CF set on error 
AX = error code (see Table 23-2) 
CF clear if successful 
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DECnet DOS 


DECnet is Digital Equipment Corporation’s trademark for their communications protocol and line of networking 
products that are compatible with Ethernet. Originally introduced with the VAX 1 1/780, DECnet became the basis for 
all of Digital’s networking products. When the company actively entered the MS-DOS arena in mid-1989, it moved to 
integrate DECnet with existing standards, and the result was DECnet DOS. 


INTERRUPT 69h - Function Oth, Subfunction 00h 





INSTALLATION CHECK 

Purpose: Determine whether the DECnet DOS CTERM module is installed. 
Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AX =0100h AL = FFh if present 


Conflicts: Zenith AT BIOS (chapter 4). 
See Also: Function 0{h Subfunction OFh 


INTERRUPT 69h - Function 01h, Subfunction 01h 


SEND BYTE 

Purpose: Transmit a character over the network on the specified connection. 

Available on: All machines. Restrictions: DECnet DOS CTERM must be installed. 
Registers at call: Return Registers: 

AX=0101h AH >= 80h on error 


BL = character 

DX = session handle 

Conflicts: Zenith AT BIOS (chapter 4). 
See Also; Function 01h Subfunction 02h 


INTERRUPT 69h - Function 01h, Subfunction 02h 


READ BYTE 

Purpose: Await a character on the specified network connection. 

Available on: All machines. Restrictions: DECnet DOS CTERM must be installed. 
Registers at call: Return Registers: 

AX = 0102h AH >= 80h on error 

DX = session handle AH< 80h if successful 


AL = character 
Conflicts: Zenith AT BIOS (chapter 4), 
See Also: Function 01h Subfunction 01h 


INTERRUPT 69h - Function 01h, Subfunction 03h 
STATUS 


Purpose: Determine the status of the specified connection. 
Available on: All machines. Restrictions: DECnet DOS CTERM must be installed. 
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Registers at call: 
AX=0103h 
DX = session handle 


Conflicts: Zenith AT BIOS (chapter 4). 
See Also: Function 01h Subfunction 04h 


INTERRUPT 69h - Function 01h, Subfunction 04h 
DECnet STATUS 


Purpose: Determine the reason for the last DECnet error. 
Available on: All machines. 

Registers at call: 

AX =0104h 

DX = session handle 


Details: Use this call when Function 01h Subfunction 03h returns a DECnet error. 


Conflicts: Zenith AT BIOS (chapter 4). 
See Also: Function 01h Subfunction 03h 


INTERRUPT 69h - Function 01h, Subfunction 05h 
OPEN SESSION 


Purpose: Establish a network connection. 
Available on: All machines. 
Registers at call: 
AX =0105h 
DS:BX -> ASCIZ node name 
ES:DX -> buffer for session control block 
(Table 24-1) 
Conflicts: Zenith AT BIOS (chapter 4). 
See Also: Function 01h Subfunctions 03h, 06h, and OAh 


Table 24-1. Format of LAT Session Control Block, 
Offset Size Description 


00h 18 BYTEs service name 
12h 18 BYTEs node name (future use) 


Return Registers: 
AH status flags 
bit 7: session has been aborted 
bit 6: DECnet error 
bit 1: trace data available 
bit 0: receive data available 
AL = reason code if DECnet error 
00h normal disconnect 
01h unknown message from host 
02h protocol violation from host 
03h could not process the initiate message 
04h error receiving message from host 
05h error sending message to host 
O6h error checking for message from host 
07h remote system does not support CTERM. 
08h remote system does not support correct 
protocol version 
09h did not receive BIND message from host 
OAh could not send BIND message to host 
OBh no more sessions available 
OCh session does not exist 
ODh not enough memory to complete operation 
OEh connection has broken 





Restrictions: DECnet DOS CTERM must be installed, 
Return Registers: 
AX = reason code (see Function 01h Subfunction 03h) 


Restrictions: DECnet DOS CTERM must be installed. 
Return Registers: 

AX <= on error 

AX > 0 session handle 
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Table 24-1. Format of LAT Session Control Block (continued) 














Offset Size Description 
24 i8 BYTEs port name (future use) 
36h DWORD  -> session stopped post routine 
3Ah DWORD  -> service table overflow post routine 
3Eh DWORD _ -> transmit post routine 
42h DWORD _ -> receive post routine 
46h WORD session status: 

04h circuit failure 

O8h stop slot received 
48 WORD slot state (LAT driver use) 
4Ah WORD local credits (LAT driver use) 
4Ch DWORD- -> VCB (LAT driver use) 
50h WORD backward slot (LAT driver use) 
52h WORD forward slot (LAT driver use) 
54) WORD remote slot ID (LAT driver use) 
56) WORD local slot ID (LAT driver use) 
58) WORD slot byte count (LAT driver use) 
SAh BYTE remote credits (LAT driver use) 
S5Bh 255 BYTEs transmitted data slot 
15Ah BYTE number of receive data slots (4 recommended) 
15Bh BYTE number of occupied slots 
15Ch BYTE index of next receive slot to use 
15Dh BYTE index of current receive slot 
15Eh WORD pointer to first received character 
160h N WORDs pointers to receive slots (buffers); each is 259 bytes 
INTERRUPT 69h - Function 01h, Subfunction 06h 
CLOSE SESSION 
Purpose: Terminate the specified network connection. 
Available on: All machines. Restrictions: DECnet DOS CTERM must be installed. 
Registers at call: Return Registers: 
AX =0106h AH = 00h good close 
DX = session handle other error code (see Function 01h Subfunction 


03h) 
Conflicts: Zenith AT BIOS (chapter 4). 
See Also: Function 01h Subfunctions 03h and 0Sh 


INTERRUPT 69h - Function 01h, Subfunction 0Ah 
GET SESSION CONTROL BLOCK SIZE 


Purpose: Determine how much space is required to store a session control block. 


Available on: All machines. Restrictions: DECnet DOS CTERM must be installed. 
Registers at call: Return Registers: 
AX =010Ah AX = length of session contro! block in bytes 


Conflicts: Zenith AT BIOS (chapter 4). 
See Also: Function 01h Subfunction 05h 


INTERRUPT 69h - Function 01h, Subfunction OBh 


GET DECnet SOCKET 

Purpose: Determine the network socket corresponding to a network connection. 

Available on: All machines. Restrictions; DECnet DOS CTERM must be installed, 
Registers at call: Return Registers: 

AX = 010Bh AX > 0 DECnet socket for the session 

DX = session handle ‘= 0 no match for handle 


Conflicts: Zenith AT BIOS (chapter 4). 
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INTERRUPT 69h - Function 01h, Subfunction OFh 


DEINSTALL CTERM 
Purpose: Remove CTERM from memory. 
Available on: All machines. Restrictions: DECnet DOS CTERM must be installed. 
Registers at call: Return Registers: 
AX =010Fh AH=00h succesful uninstall 
other error code (see Function 01h Subfunction 
03h) 


Details: CTERM must have been the last TSR loaded in order to deinstall it. 
Conflicts: Zenith AT BIOS (chapter 4). 
See Also: Function 01h Subfunction 00h 


INTERRUPT 6Ah 
LOCAL AREA TRANSPORT PROGRAM 


Purpose: Determine whether the DECnet DOS Local Area Transport program is installed. 
Available on: All machines. Restrictions: none. 

Details: The 3 bytes preceding the interrupt handler are "LAT"; this serves as the installation check. 
Conflicts: OPTHELP.COM (chapter 36). 


INTERRUPT 6Ah - Function 01h 


SEND BYTE 

Purpose: Transmit a character over the specified network connection. 

Available on: All machines. Restrictions: DECnet DOS Local Area Transport 
program must be installed. 

Registers at call: Return Registers: 

AH = Olh AH >= 80h on error 

AL = character 

DH = FFh 

DL = handle 

Conflicts: OPTHELP.COM (chapter 36). 

See Also: Function 02h 

INTERRUPT 6Ah - Function 02h 

READ BYTE 

Purpose: Await a character on the specified network connection, 

Available on: All machines. Restrictions: DECnet DOS Local Area Transport 
program must be installed. 

Registers at call: Return Registers: 

AH = 02h AH < 80h if successful 

DH = FFh AL = character 

DL = handle AH >= 80h on error 

Conflicts: OPTHELP.COM (chapter 36). 

See Also: Function 01h 

INTERRUPT 6Ah - Function 03h 

STATUS 

Purpose: Determine the status of the specified network connection. 

Available on: All machines. Restrictions; DECnet DOS Local Area Transport 
program must be installed. 

Registers at call: Return Registers: 

AH = 03h AH = status flags 


DH = FFh bit 5: transmit buffer empty 





DL = handle 


Conflicts; OPTHELP.COM (chapter 36). 


INTERRUPT 6Ah - Function DOh 
OPEN SESSION 


Purpose: Establish a network connection. 
Available on: All machines, 


Registers at call: 
AH = DOh 
AL = FFh no password 
= OFh password at ES:DI 
DH = FFh 
DS:BX -> LAT session control block (Table 24-1) 
ES:DI -> 16-byte blank-padded password 
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bit 3: session in start state 

bit 2: session not active 

bit 1: unable to queue transmit data 
bit 0: receive data available 


Restrictions: DECnet DOS Local Area Transport 
program must be installed. 

Return Registers: 

AH = 00h success 

DL = handle 


Details: The caller should set post routines to 0000h:0000h if polled operation will be used. 


Conflicts; OPTHELP.COM (chapter 36). 
See Also: Function DOh Subfunction 00h 


INTERRUPT 6Ah - Function DOh, Subfunction 00h 


CLOSE SESSION 


Purpose: Terminate the specified network connection, 
Available on: All machines, 


Registers at call: 

AX = D000h 

DH = FFh 

DL = handle 

Conflicts: OPTHELP.COM (chapter 36). 
See Also: Function DOh 


INTERRUPT 6Ah - Function Dih, Subfunction 00h 


SEND BREAK 


Restrictions: DECnet DOS Local Area Transport 
program must be installed. 
Return Registers: 
AX = 0000h successful 
= 0001h no such session 
= 0002h session not running, try again later 


Purpose: Send a signal on the specified connection requesting an interruption in the normal flow of data on that 


connection. 
Available on: All machines. 


Registers at call: 
AX =D100h 

DH = FFh 

DL = handle 


INTERRUPT 6Ah - Function D3h, Subfunction 00h 


RESET LAT COUNTERS 


Restrictions: DECnet DOS Local Area Transport 
program must be installed. 

Return Registers: 

AX = 0000h if successful 

AH bit 7 set if unable to send break 


Purpose: Zero the data transfer statistics for the Local Area Transport program. 


Available on: All machines. 


Registers at call: 
AX = D300h 
DH = FFh 


Restrictions; DECnet DOS Local Area Transport 
program must be installed. 
Return Registers: n/a 
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rConflicts: OPTHELP.COM (chapter 36). 
See Also: Function D4h Subfunction 00h 


INTERRUPT 6Ah - Function D4h, Subfunction 00h 


COPY LAT COUNTERS 

Purpose: Retrieve the transfer statistics for the Local Area Transport program. 

Available on: All machines, Restrictions: DECnet DOS Local Area Transport 
program must be installed. 

Registers at call: Return Registers: 

AX = D400h AX =0000h counters copied into buffer 

DH = FFh =: FFFFh buffer too small 


CX = buffer size 

ES:BX -> buffer for LAT counters 
Conflicts: OPTHELP.COM (chapter 36). 
See Also: Function D3h Subfunction 00h 


INTERRUPT 6Ah - Function DSh, Subfunction 00h 
GET NEXT LAT SERVICE NAME 


Purpose: Retrieve the names of the hosts on the network, one name per call. 


Available on: All machines. Restrictions; DECnet DOS Local Area Transport 
program must be installed. 

Registers at call: Return Registers: 

AX = D500h AH = 00h if successful 

DH = FFh ES:BX buffer filled 

ES:BX -> 17-byte buffer for name AX = FFFFh if end of table or no name available 


Conflicts: OPTHELP.COM (chapter 36). 
See Also: Function D6h Subfunction 00h 


INTERRUPT 6Ah - Function D6h, Subfunction 00h 
LAT SERVICE TABLE RESET 


Purpose: Set pointer to next name to retrieve back to beginning of table, and determine number of entries in the 
table. 


Available on: All machines. Restrictions; DECnet DOS Local Area Transport 
program must be installed. 

Registers at call: Return Registers: 

AX = D600h AX = number of service table entries 

DH = FFh BX = 0000h service table has not overflowed 


= FFFFh service table has overflowed 
Conflicts: OPTHELP.COM (chapter 36). 
See Also: Function DSh Subfunction 00h 


INTERRUPT 6Dh 
DATA LINK LAYER PROGRAM API 


Purpose: Access the Data Link Layer program. 
Available on: All machines. Restrictions: DECnet DOS must be installed. 
Conflicts: VGA (chapter 5), ATI VGA Wonder (chapter 5). 


INTERRUPT 6Eh 
DECnet NETWORK PROCESS API 


Purpose: Access the network process. 
Available on: All machines, Restrictions: DECnet DOS Network must be installed. 
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Details: This is the main DECnet DOS access, and is described in Digital manual AA-EB46B-TV ("DECnet-DOS 
Programmer's Reference Manual"). There is a signature/data area (Table 24-2) immediately prior to the interrupt 
handler which may be used as an installation check. 

Conflicts: None known. 


Table 24-2. Format of Signature Area: 


Offset Size Description 

- BYTE major version number 

4 BYTE minor version number 

3 3BYTEs — signature (ASCII “DNP") 
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APPC/PC 


IBM’s Advanced Program-to-Program Communication is one protocol within the Systems Network Architecture; itis 
roughly equivalent to the OSI’s "session layer” and according to company press releases, is the communications basis 
for all future applications and system products. APPC/PC is the software package for personal computers that im- 


plements one end of the APPC protocol; the mainframe end of the link is handled by LU 6.2. 


APPC/PC has yet to establish itself in the PC world despite its official blessing, but its interface will be of interest 


to all programmers faced with a need to communicate with IBM mainframes, 


INTERRUPT 68h - Function 01h 

APPC/PC - NETWORK DEVICE CONTROL 

Purpose: Attach or detach physical or logical units, 
Available on: All machines. 

Registers at call: Return Registers: n/a 
AH =01h 

DS:DX -> control block (Table 25-1) 

Conflicts: Sangoma CCPOP 3270 resident module (chapter 26). 


Table 25-1. ForMat Of Control Block: 


Offset Size Description 

00h 12 BYTEs _ reserved 

0Ch WORD verb (action) 

OEh 6BYTEs 00h 

14h DWORD (high byte first) return code (Table 25-2) 

---if verb = 1B00h (DISPLAY) 

18h WORD 00h 

1Ah 8BYTEs (high byte first) logical unit ID 

22h S8BYTEs (high byte first) partner logical unit name 

2Ah 8BYTEs (high byte first) mode name 

32h BYTE logical unit session limit 

33h BYTE partner logical unit session limit 

34h BYTE node maximum negotiable session limit 

35h BYTE current session limit 

36h BYTE minimum negotiated winner limit 

37h BYTE maximum negotiated loser limit 

38h BYTE active session count 

39h BYTE active CONWINNER session count 

3Ah BYTE active CONLOSER session count 

3Bh BYTE session termination count 

3Ch BYTE bit 7: SESSION_TERMINATION_TARGET_DRAIN 
bit 6: SESSION_TERMINATION_SOURCE_DRAIN 

---if verb=2000h (Attach Physical Unit) 

18h WORD 00h 

tAh BYTE version 

1Bh BYTE release 





Restrictions: APPC/PC software must be installed. 
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Table 25-1. Format of Control Block (continued) 


Offset 
1Ch 
24h 
2Ch 
34h 
38h 
3Ch 


18h 
1Ah 
22h 
2Ah 
2Bh 
2Ch 


30h 
34h 
38h 
3Ch 
3Dh 
3Eh 
42h 
46h 


Size 

8 BYTEs 
8 BYTEs 
8 BYTEs 
DWORD 
DWORD 
BYTE 


WO! 

8 BYTEs 
8 BYTEs 
BYTE 
BYTE 
DWORD 


DWORD 
DWORD 
DWORD 
BYTE 
BYTE 
DWORD 
DWORD 
WORD 
for each pi 

WORD 
WORD 
8 BYTEs 
BYTE 


BYTE 

WORD 

8 BYTEs 

BYTE 

17 BYTEs 

WORD 
for each mi 

WORD 

8 BYTEs 

WORD 

WORD 

BYTE 

BYTE 


Description 

(high byte first) net name 

(high byte first) physical unit name 

00h. 

pointer to SYSTEM_LOG_EXIT routine, FFFFFFFFh=don't log errors 
00h 

00h RETURN_CONTROL: COMPLETE 

0th RETURN_CONTROL: INCOMPLETE 


---if verb=2100h (Attach Logical Unit) 
RD 


70 offset to partner logical unit record 
(high byte first) logical unit name 
(high byte first) logical unit ID 
logical unit local address 
logical unit session limit 
pointer to CREATE_TP_EXIT routine, 
FFFFFFFFh = reject incoming ALLOCATEs 
00000000h = queue ALLOCATEs 
00h 
pointer to SYSTEM_LOG_EXIT routine, FFFFFFFFh=don't log errors 
00h 
maximum TPs 
queue depth 
pointer to LU_LLU_PASSWORD_EXIT routine, FFFFFFFFh=no pswd exit 
00h 
total length of partner records 
artner logical unit: 
length of this partner logical unit record 
42 offset to mode records 
(high byte first) partner logical unit name 
partner logical unit security capabilities 
bit 7: already verified 
bit 6: conversation level security 
bit 5: session level security 
partner logical unit session limit 
partner logical unit maximum MC_SEND_LL 
(high byte first) partner logical unit DLC name 
partner logical unit adapter number 
(counted string) partner logical unit adapter address 
total length of mode records 
ode: 
16 length of this mode record 
(high byte first) mode name 
RU_SIZE high bound 
RU_SIZE low bound 
mode maximum negotiable session limit 
pacing size for receive 


-~if verb=2200h (Detach Logical Unit) 


18h 
20h 


8 BYTEs 
BYTE 


(high byte first) logical unit ID 
00h 


-~if verb=2700h (Detach Physical Unit} 


18h 


BYTE 


00h type: hard 
Oth type: soft 


-—-if verb=2B00h (Activate DLC) 


18h 
20h 


8 BYTEs 
BYTE 


(high byte first) DLC name 
adapter number 
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Table 25-2. Values for Return Code: 








/ Value Meaning 
| 0000) successful 
| 0001h BAD_TP_ID 
i 0002h BAD_CONV_ID 
| 0003h bad logical unit ID 
\ 0008h no physical unit attached 
0110h bad state 
| O!BIh BAD_PART_LUNAME 
| O1B2h bad mode name 
| 0201h physical unit already active 
\ 0211 logical unit already active 
i 0212: BAD_PART_SESS 
i 0213: BAD_RU_SIZES 
0214h BAD_MODE_SESS 
i 0216h BAD_PACING_CNT 
| 0219h EXTREME_RUS 
| 02iAh  SNASVCMG_1 
| 0223h SSCP_CONNECTED_LU 
| 0230h invalid change 
\ 0243h too many TPs 
| 0272h adapter close failure 
0281 GET_ALLOC_BAD_TYPE 
0282h unsuccessful 
0283h DLC failure 
| 0284h unrecognized DLC 
| 0286h duplicate DLC 
! 0301h SSCP_PU_SESSION_NOT_ACTIVE 
| 0302. data exceeds RU size 
0401 invalid direction 
0402h invalid type 
0403h segment overlap 
0405h table error 
0406h conversion error 


| 

| 

0404h invalid first character 
F0010000h APPC disabled 
F0020000h APPC busy 
F0030000h APPC abended 
F0040000h incomplete 

Routines defined by LU_LU_LPASSWORD_EXIT, CREATE_TP_EXIT, and SYSTEM_LOG_EXIT pointers 
| are called by pushing the DWORD pointer to the verb on the stack and then performing a FAR call. 
| 


Table 25-3, Format of ACCESS_LU_LU_PW verb: 


Offset Size Description 
| 00h 12 BYTEs reserved 
\ 0Ch WORD 1900h 
i OEh 8BYTEs (high byte first) logical unit ID 
| 16h 8BYTEs (high byte first) logical unit name 
i 1Eh 8 BYTEs (high byte first) partner logical unit name 
i 26h 17 BYTEs (counted string) partner fully qualified logical unit name 
| 37h BYTE password available (0=no, 1=yes) 


38h 8BYTEs password 
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Table 25-4. Format of CREATE_TP Verb: 


Offset Size Description 

00h 12 BYTEs reserved 

0Ch WORD 2300h 

OEh 6BYTEs 00h 

14h DWORD (high byte first) sense code 
00000000h Ok 
080F605 Ih SECURITY_NOT_VALID 
084B6031h TP_NOT_AVAIL_RETRY 
084C0000h TP_NOT_AVAIL_NO_RETRY 
10086021h TP_NAME_NOT_RECOGNIZED 
10086034h CONVERSATION_TYPE_MISMATCH 
1008604 1h SYNC_LEVEL_NOT_SUPPORTED 

i8h 8BYTEs (high byte first) TP ID 

20h 8BYTEs (high byte first) logical unit ID 

28h DWORD (high byte first) conversation ID 

2Ch BYTE 0 basic conversation, 1 mapped conversation 

2Dh BYTE 0 no sync level, 1 confirm 

2Eh BYTE reserved 

2Fh 65 BYTEs (counted string) transaction program name 

70h 6BYTEs 00h 

Toh WORD length of ERROR_LOG_DATA to return 

78h DWORD pointer to ERROR_LOG_DATA buffer 

7Ch 8BYTEs (high byte first) partner logical unit name 

84h 18 BYTEs (counted string) partner fully qualified logical unit name 

96h 8BYTEs (high byte first) mode name 

9Eh 12BYTEs 00h 

AAh 11 BYTEs (counted string) password 

BSh 11 BYTEs (counted string) user ID 

CO) BYTE 0 verification should be performed 





1 already verified 


Table 25-5. Format of SYSLOG Verb: 


Offset Size Description 

00h 12 BYTEs reserved 

0Ch WORD ~—.2600h 

OEh 10BYTEs 00h 

18h WORD (high byte first) type 

1Ah DWORD (high byte first) subtype 

1Eh DWORD pointer to ADDITIONAL_INFO 
22h DWORD (high byte first) conversation ID 
26h 8BYTEs (high byte first) TP ID 

2Eh 8BYTEs (high byte first) physical unit or logical unit name 
36h WORD length of data 

38h DWORD pointer to data 

3Ch BYTE 00h 


INTERRUPT 68h - Function 02h 
APPC/PC - CONNECTION CONTROL 


Purpose: Establish or terminate network connections, or send or receive data over an established connection. 


Available on: All machines. Restrictions: APPC/PC software must be installed. 
Registers at call: Return Registers: n/a 
AH = 02h 


DS:DX -> control block (Table 25-6) 
Conflicts: Sangoma CCPOP 3270 resident module (chapter 26). 


Table 25-6. Format of Control Block: 


Offset Size Description 
00h 12 BYTEs reserved 
0Ch WORD verb (action) 
OEh BYTE 1 if MC_ (mapped conversation) form of verb 

0 if basic verb 
OFh SBYTEs reserved (0) 
14h WORD (high byte first) primary return code (Table 25-7) 
16h DWORD (high byte first) error code (Table 25-8) 
1Ah 8BYTEs (high byte first) TP_ID 
22h DWORD (high byte first) conversation ID 
---if verb=0100h (Allocate or MC. Allocate) 
26h BYTE (MC_Allocate only) 0 basic conversation 

1 mapped conversation 

27h BYTE 00h SYNC_LEVEL = none 

Oth SYNC_LEVEL = confirm 
28h WORD 0000h 
2Ah BYTE 00h RETURN_CONTROL: when session allocated 


Olh RETURN, CONTROL: immediate 
02h RETURN_CONTROL: when session free 


2Bh 8BYTEs 00h 

33h 8BYTEs (high byte first) partner logical unit name 
3Bh 8BYTEs (high byte first) mode name 

43h 65 BYTEs (counted string) TP name 

84h BYTE 00h security: none 


Olh security: same 
02h security: pgm 


85h 11 BYTEs 00h 

90h 11 BYTEs (counted string) password 

9Bh 11 BYTEs (counted string) user ID 

A6h WORD PIP_DATA length 

A8h DWORD pointer to PIPLDATA 

---if verb=0300h (Contirm or MC_Contirm) 

26h BYTE request to send received (O=no, 1=yes) 


---if verb=0400h (Confirmed or MC_Contirmed), no additional fields 
---if verb=0500h (Deallocate Bs He Peatocate) 


26h BYTE 
27h BYTE type 0 SYNC_LEVEL 
1 FLUSH 
2 ABEND_PROC 
3 ABEND_SVC 
4 ABEND_TIMER 
5 ABEND 
28 WORD (MC_Deallocate only) length of error log data 
2Ah DWORD = (MC__Deallocate only) pointer to error log data 


---if verb=0600h (Flush or MC_Flush), no additional fields 
-~if verb=0700h (Get_Attributes or MC_Get_Attributes) 





26h 8BYTEs (high byte first) logical unit ID 

2Eh BYTE 00h. 

2Fi BYTE SYNC_LEVEL (0=none, 1=confirm) 
30h 8BYTEs (high byte first) mode name 

38h 8BYTEs (high byte first) own net name 

40h 8BYTEs (high byte first) own logical unit name 
48) 8BYTEs (high byte first) partner logical unit name 


50h 18 BYTEs (counted string) partner's fully qualified logical unit name 
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25-6 APPC/PC 


Table 25-6. Format of Control Block (continued) 


Description 
00h 


11 BYTEs (counted string) user ID 


type (O=basic conversation, 1=mapped conversation) 


maximum length 
fill (O=buffer, 1=LL) 


---if verb=0A00h (Prepare_to_Receive or MC_Prepare_to_Receive) 


type (0=SYNC_LEVEL, [=FLUSH) 
locks (O=short, 1=long) 


---if verb=0B00h (Receive _and_Wait or MC_Receive_and_Wait) 


what received 

00h data 

Olh data complete 

02h data incomplete 

03h confirm 

04h confirm send 

05h confirm deallocate 

06h send 
(MC_Receive_and_Wait only) fill (0=buffer, 1=LL) 
Request_to_Send_Received (O=no, l=yes) 
maximum length 
data length 
pointer to data 


---if verb=0C00h (Receive_Immediate or MC_Receive_immediate) 


what received 

00h data 

O1h data complete 

02h data incomplete 

03h confirm 

04h confirm send 

05h confirm deallocate 

O6h send 
(MC_Receive_Immediate only) fill (O=buffer, 1=LL) 
Request_to_Send_Received (O=no, 1=yes) 
maximum length 
data length 


Offset Size 

62h BYTE 
63h 

-—-if verb=0800h (Get_Type) 
26h. BYTE 
---if verb=0900h (Post_on_ Receipt) 
26h WORD 
28h BYTE 
26h BYTE 
27h BYTE 
26h BYTE 
27h BYTE 
28h BYTE 
29h WORD 
2Bh WORD 
2Dh DWORD 
26h BYTE 
27h BYTE 
28h BYTE 
29h WORD 
2Bh WORD 
2Dh DWORD 


pointer to data 


-~-if verb=0E00h (Request_to, Send or MC_Request_to_Send), no other fields 
---if verb=0F 00h (Send_Data or MC_Send_Data) 


26h 
27h 
28h 
2Ah 


BYTE 
BYTE 
WORD 
DWORD 


request to send received (O=no, 1=yes) 
00h 

data length 

pointer to data 


---if verb=1000h (Send_Error or MC_Send_Error) 


26h 
27h 
28h 
2Ch 
2Eh 


BYTE 
BYTE 
DWORD 
WORD 
DWORD 


request to send received (O=no, 1=yes) 

type (O=program, 1=SVC) 

00h 

(MC_Send_Error only) LOG_DATA length 
(MC_Send_Error only) pointer to LOG_DATA 
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Table 25-6. Format of Control Block (continued) 


Offset Size Description 
--if verb=1200h (Test or MC_Test} 
26h BYTE (MC_Test only) test (O=posted, |=request_to_send received) 


Note: error code has different interpretations for: 
0 posted data 
1 posted not data (primary return code = 0) 
1 bad TP_ID (primary return code = 1) 


---if verb=1300h (Wait) 
26h BYTE number of conversations to wait on 
Note: error codes have interpretations as for 1200h above 


Table 25-7. Values for primary return code: 





Value Meaning Value Meaning 

0000h successful 000Eh PROG_ERROR_PURGING 
0001h parameter check O00F! CONV_FAILURE_RETRY 
0002h state check 0010h CONV_FAILURE_NO_RETRY 
0003h allocation error O0011h SVC_ERROR,NO_TRUNC 
0005h deallocate abended 0012) SVC_ERROR_TRUNC 

0006h deallocate abended program 0013 SVC_ERROR_ PURGING 

0007h deallocate abended SVC 00141 unsuccessful 

0008h deallocate abended timer 0018) CNOS partner logical unit reject 
0009h deallocate normal return 0019h conversation type mixed 

000Ah data posting blocked F001 APPC disabled 

O0O00Bh posting not active F002! APPC busy 

000Ch PROG_ERROR_NO_TRUNC F003h APPC abended 

000Dh PROG_ERROR_TRUNC F004! incomplete 

Table 25-8. Values for error code: 

Value Meaning Value Meaning 

0001h bad TP ID 0055h deallocate: NOT_LL_BDY 

0002h bad conversation ID 0057h deallocate: log LL_WRONG 
0004h allocation error, no retry 0061h flush: not send state 

0005h allocation error, retry 0091h post on receipt: invalid length 
0006h data area crosses segment boundary 0092h post on receipt: not in receive state 
0010h bad TPN length 0093h post on receipt: bad fill 

O01 Lh bad CONV length OOAIh prepare to receive:invalid type 
0012h bad SYNC level 00A2h prepare to receive: unfinished LL 
0013h bad security selection OO0A3h prepare to receive: not in send state 
0014h bad return control 00B 1h receive and wait: bad state 

0015h SEC_TOKENS too big 00B2h receive and wait: NOT_LL_BDY 
0016h PIP_LEN incorrect O0OBSh receive and wait: bad fill 

0017h no use of SNASVCMG 00C1h receive immediate: not in receive state 
0018h unknown partner mode 00C4h receive immediate: bad fill 

003th confirm: SYNC_NONE QOE1h request to send; not in receive state 
0032h confirm: bad state QOOFih send data: bad LL. 

0033h confirm: NOT_LL_BDY OOF2h send data: not in send state 

0041h confirmed: bad state 0102h send error: log LL wrong 

005 1h deallocate: bad type 0103h send error: bad type 

0052h deallocate: flush bad stat 012th test: invalid type 

0053h deallocate: confirm bad state 0122h test: not in receive state 
INTERRUPT 68h - Function 03h 

APPC/PC 


Purpose: Miscellaneous network control. 
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Available on: All machines. Restrictions: APPC/PC software must be installed. 
Registers at call: Return Registers: n/a 
AH = 03h 


DS:DX -> control block (Table 25-9) 
Conflicts: Sangoma CCPOP 3270 resident module (chapter 26). 


Table 25-9. Format of Control Block: 


Offset Size Description 

00h 12 BYTEs reserved 

0Ch WORD verb (action) 

OEh 6BYTEs 0 

14h DWORD (high byte first) return code (see Function 01h) 
18h WORD 0 

1Ah 8BYTEs (high byte first) logical unit ID 
---if verb=2400h (TP Started), control block continues 

22h 8BYTEs (high byte first) TP ID 

--if verb=2800h (Get ALLOCATE), contro! block continues 

22h BYTE type: 00h dequeue 

Olh test 

23h DWORD pointer to CREATE_TP record 
---if verb=2A00h (Change Logical Unit}. control block continues 

22h DWORD _ pointer to CREATE_TP_EXIT routine 


FFFFFFFFh reject incoming ALLOCATEs 
00000000h queue ALLOCATEs 





26h DWORD 00000000h 
2Ah DWORD pointer to SYSTEM_LOG_EXIT routine, FFFFFFFFh= don't log errors 
2Eh DWORD 00000000h 
32h BYTE maximum TPs 
33h BYTE 00h stop QUEUE_ALLOCATEs 
Olh resume QUEUE_ALLOCATEs 
34h DWORD pointer to LU_LLU_PASSWORD_EXIT routine, FFFFFFFFh = no exit 
38) DWORD 00000000h 


INTERRUPT 68h - Function 04h 
APPC/PC - TRANSACTION PROCESSING 


Purpose: Start or end transaction processing. 


Available on: All machines. Restrictions: APPC/PC software must be installed. 
Registers at call: Return Registers: n/a 
AH = 04h 


DS:DX -> control block (Table 25-10) 
Conflicts: Sangoma CCPOP 3270 resident module (chapter 26). 


Table 25-10. Format of Control Block: 


Offset Size Description 
00h 12 BYTEs reserved 
0Ch WORD verb (action) 


2500h TP_ENDED 
2900h TP_VALID 


OEh 6BYTEs 0 

14h DWORD (high byte first) return code (see Function 01h) 
18h WORD 0: 

1Ah 8BYTEs (high byte first) TP_ID 


22h DWORD _ -> CREATE_TP record (only if verb = 2900h) 
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INTERRUPT 68h - Function 05h 


TRANSFER MESSAGE DATA 

Purpose: Send a message of user-defined format. 

Available on: Ail machines. Restrictions: APPC/PC software must be installed. 
Registers at call: Return Registers: 

AH = 05h n/a 


DS:DX -> control block (Table 25-11) 
Conflicts: Sangoma CCPOP 3270 resident module (chapter 26). 


Table 25-11. Format of Control Block: 


Offset Size Description 
00h 12 BYTEs reserved 
0Ch WORD 1C00h 
OEh BYTE 00h user defined 
01h NMVT 


02h alert subvectors 
03h PDSTATS subvectors 


OFh 5BYTEs 0 

14] DWORD (high byte first) return code (see Function 01h) 
18) 12BYTEs 0 

24h BYTE if bit 0 clear, add correlation subvector 


if bit 1 clear, add product set ID subvector 
if bit 2 clear, do SYSLOG 
if bit 3 clear, send SSCP_PU_SESSION 








25h BYTE 0 
26h WORD length of data 
28h NBYTEs data 


INTERRUPT 68h - Function 06h 
CHANGE NUMBER OF SESSIONS 


Purpose: Specify the number of concurrent network connections allowed. 


Available on: All machines. Restrictions: APPC/PC software must be installed. 
Registers at call: Return Registers: n/a 
AH = 06h 


DS:DX -> control block (Table 25-12) 
Conflicts: Sangoma CCPOP 3270 resident module (chapter 26). 


Table 25-12. Format of Control Block: 


Offset Size Description 

00h 12 BYTEs reserved 

0Ch WORD 1500h 

OEh 6BYTEs 0 

14h WORD (high byte first) primary return code (see Function 02h) 

16h DWORD (high byte first) secondary return code (see Table 25-13, Function 01h) 
1Ah 8BYTEs high byte first) logical unit ID 

22h 8BYTEs _ blanks 

2Ah 8BYTEs (high byte first) partner logical unit name 

32h 8BYTEs (high byte first) mode name 

3Ah BYTE bit 7: use MODE_NAME,SELECT_ALL rather than MODE_NAME 

bit 6: set negotiable values 

3Bh BYTE partner logical unit mode session limit 

3Ch BYTE minimum CONWINNERS_SOURCE 

3Dh BYTE maximum CONWINNERS_TARGET 


3Eh BYTE automatic activation 
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Table 25-12. Format of Control Block {continued} 


Offset Size Description 
3Fh BYTE 0 
40h BYTE bit 7: drain target 


bit 6: drain source 
bit 5: target responsible, not source 


Table 25-13. Values for Secondary Return Code (see also Function OLh): 


Value Meaning Value Meaning 
0000h accepted 0156h mode closed (prim return code = 1) 
0001h negotiated CNOS mode closed (prim return code = 18h) 
0003h bad logical unit ID 0157h bad mode name (prim return code = 1) 
0004h allocation failure, no retry CNOS bad mode name (prim return code = 18h) 
000Sh allocation failure, retry 0159h reset SNA drains 
015th can't raise limits 015Ah single not SRC response 
0153h all modes must reset O1SBh bad partner logical unit 
0154h bad SNASVCMG limits 015Ch exceeds maximum allowed 
0155h minimum greater than total 015Dh change SRC drains 

OISEh logical unit detached 

O15Fh CNOS command race reject 
INTERRUPT 68h - Function 07h 
PASSTHROUGH 
Purpose: Invoke an installable application subsystem. 
Available on: All machines. Restrictions: APPC/PC software must be installed. 
Registers at call: Return Registers: n/a 
AH =07h 


DS:DX -> control block (format depends on 

application subsystem) 
Conflicts: Sangoma CCPOP 3270 resident module (chapter 26). 
See Also: Function FFh 


INTERRUPT 68h - Function FAh 
ENABLE/DISABLE APPC 


Purpose: Specify whether APPC should respond to function calls. 
Available on: All machines. Restrictions: APPC/PC software must be installed. 
Registers at call: Return Registers: n/a 
AH =FAh 
AL bit 0 = 0 enable 
1 disable 
Conflicts: Sangoma CCPOP 3270 resident module (chapter 26). 


INTERRUPT 68h - Function FBh 


CONVERT DATA 

Purpose: Translate text between ASCII and EBCDIC formats. 

Available on: All machines. Restrictions: APPC/PC software must be installed. 
Registers at call: Return Registers: n/a 

AH = FBh 


DS:DX -> control block (Table 25-14) 
Conflicts: Sangoma CCPOP 3270 resident module (chapter 26). 





| 
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Table 25-14. Format of Control Block: 


Offset Size Description 
00h 12BYTEs reserved 
0Ch WORD 1A00h 
OEh 6BYTEs 0 
14h DWORD (high byte first) return code 
18h BYTE conversion: 00h ASCII to EBCDIC 
Olh EBCDIC to ASCIL 
19h BYTE character set: 00h AE 
OIhA 
02hG 
[Ah WORD length of string to convert 
1Ch DWORD pointer to source 
20h DWORD pointer to target 


INTERRUPT 68h - Function FCh 
ENABLE/DISABLE MESSAGE TRACING 


Purpose: Specify whether message traffic should be traced. 


Available on: All machines. Restrictions: APPC/PC software must be installed. 
Registers at call: Return Registers: n/a 
AH = FCh 


AL = 00h disable tracing 
= Oh enable tracing 
DX = number of bytes to keep (O=all) 
Conflicts: Sangoma CCPOP 3270 resident module (chapter 26). 
See Also: Function FDh 


INTERRUPT 68h - Function FDh 
ENABLE/DISABLE API VERB TRACING 


Purpose: Specify whether API calls should be traced. 


Available on: All machines. Restrictions: APPC/PC software must be installed. 
Registers at call: Return Registers: n/a 
AH = FDh 


AL = 00h disable tracing 

= Olh enable tracing 
Conflicts: Sangoma CCPOP 3270 resident module (chapter 26). 
See Also: Functions FCh and FEh 


INTERRUPT 68h - Function FEh 
SET TRACE DESTINATION 


Purpose: Determine where trace messages will be output. 


Available on: All machines. Restrictions: APPC/PC software must be installed. 
Registers at call: Return Registers: n/a 
AH = FEh 


AL = trace destinations 

bit 0 storage (DS:DX -> trace stats record, 

Table 25-15) 

bit 1 display 

bit 2 file (trace written to file OUTPUT,PC) 

bit 3. printer 
Details: The statistics record may not be moved while the trace is active. 
Conflicts: Sangoma CCPOP 3270 resident module (chapter 26). 


25-12 APPC/PC 


See Also: Function FDh 


Table 25-15. Format of Trace Statistics Record: 


Offset Size Description 

00h DWORD pointer to storage trace buffer 

04h WORD max number of 80-byte records in trace 

06h WORD (high-order byte first!) current record number (must init to 0) 
08h DWORD (high-order byte first!) number of records written (init to 0) 
0Ch DWORD _ reserved 

INTERRUPT 68h - Function FFh 

SET PASSTHROUGH 


Purpose: Specify the function which is to handle passthrough requests; this allows a subsystem to install itself into 
APPC/PC. 


Available on: All machines. Restrictions: APPC/PC software must be installed. 
Registers at call: Return Registers: n/a 
AH = FFh 


DS:DX -> passthrough exit routine 
Conflicts: Sangoma CCPOP 3270 resident module (chapter 26). 
See Also: Function 07h 


H 
| 
| 
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IBM Mainframe Connectivity 


A number of products that provide connectivity between PC’s and IBM mainframe systems exist, but we have spe- 
cific information on only two groups that make special use of the PC interrupt structure (most operate simply as ter- 
minal emulators and leave it to the mainframe software to handle terminal communications), These are the IBM 
System 36/38 Workstation emulator (a single program), and those programs which emulate the IBM3270 terminal. 


IBM System 36/38 

The IBM System 36/38 Workstation emulator makes the PC appear, to a System 36/38, to be nothing more than an- 
other workstation. While the emulator program is running, no other DOS applications can be active; for this reason, 
conflicts between this emulator and other programs are of little consequence. 


INTERRUPT 0Ch 
IBM SYSTEM 36/38 WORKSTATION EMULATION - API POINTER 


Purpose: Provides pointer to API. Call offset 100h in the interrupt handler’s segment. 





Available on: All machines. Restrictions: Emulator software must be installed. 
Registers at call: Return Registers: 
AH = function AL = session type code 
03h update screen 00h not active 
05h select next session Oth display session 
AL = session number (00h-03h) 02h printer session 


FEh invalid session number 
DS = requested sessi’s data segment (0 if not active) 
Conflicts: COM1 (chapter 2). 


Table 26-1. Format of Emulator’s Data Area (offsets into interrupt handler's segment): 








Offset Size Description 
13Eh BYTE bit flags for status line indicators turned on since this byte was last zeroed 
13Fh BYTE bit flags for status line indicators turned off since this byte was last set to FFh 
40h WORD offset of EBCDIC to ASCII translation 
46 WORD offset of EBCDIC screen buffer 
48) WORD offset of EC (engineering change) level signature 
50h BYTE “KEYI" 
51 BYTE 5250 key scan code to be sent to remote 
5Bh BYTE "SYSAV" 
5Dh BYTE 5250 cursor column 
SEh BYTE 5250 cursor row 
67 BYTE “DVCTAD" 
78h BYTE "FLAGS" 
184 BYTE "SESSNOAD" 
93) BYTE "STNAD" 
98h BYTE "NSDS" 
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INTERRUPT 21h - Function 44h, Subfunction 02h 
VDLSYS - GET Unknown Data 


Purpose: unknown. 


Available on: All machines. Restrictions; IBM System 36/38 Workstation 
Emulation software must be installed. 

Registers at call: Return Registers: 

AX = 4402h CF set on error 

BX = handle for character device "GDMS" AX = error code (see Function 59h) 

CX = number of bytes to read (>= 4) CF clear if successful 

DS:DX -> buffer (see below) AX = number of bytes read 


Conflicts: DOS 2+ IOCTL Read Control (chapter 8), Network Driver Interface Spec 2.0.1 (chapter 27), 
HIGHUMM.SYS - IOCTL - Get API Address (chapter 36). 


Table 26-2. Format of returned data: 


Offset Size Description 

00h 4BYTEs unknown. 

04h DWORD pointer to unknown. 
08h 4BYTEs unknown. 

IBM 3270 Emulation 


At least six different packages for the PC provide emulation of the IBM 3270 terminal for mainframe connectivity. 
They are Attachmate Extra; IBM's PC3270 emulator; Tangram Arbiter, which makes a PC disk look like a slow 
mainframe disk over an SNA link to the mainframe; Sangoma's CCIP Interface; the IBM 3270 Workstation Program 
(which is not the same as the PC3270 emulator); and Eicon Access. 


INTERRUPT 21h - Function AOh 


GET 3270 DISPLAY STATE 


Purpose: Determine which windows on the emulated 3270 terminal are available and/or displayed, and which is 
currently active. 


Available on: All machines, Restrictions: Attachmate Extra must be installed. 
Registers at call: Return Registers: 
AH = AOh AL = display status: 


bit 7 : 0=windowed, |=enlarged 
bits 6-3: current screen profile number 
0-9 
bits 2-0: active window number: 0=PC, 
1-4=host B-E, 5-6=notepad F-G 
BX = host window status: 

bit 15: reserved 

bit 14: O=host BE window installed, 
1=not 

bit 13: O=host E terminal on, 
l=off 

bit 12: 0=host E window displayed, 
1=not 

bit 11: reserved 

bit 10: O=host D window installed, 
1=not 

bit 9: O=host D terminal on, 
l=off 

bit 8: O=host D window displayed, 
1=not 
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bit 7: reserved 
bit 6: O=host C window installed, 
isnot 
bit 5: O=host C terminal on, 
l=off 
bit 4: O=host C window displayed, 
l=not 
bit 3: reserved 
bit 2: O=host B window installed, 
i=not 
bit 1: O=host B terminal on, 
l=off 
bit 0: O=host B window displayed, 
1=not 
Details: Attachmate Extra is a 3270 emulator by Attachmate Corporation. 
Conflicts: None known. 
See Also: Function Alh 


INTERRUPT 21h - Function Aih 
SET 3270 DISPLAY STATE 


Purpose: Specify which window of the emulated 3270 terminal will be active. 


Available on: All machines. Restrictions: Attachmate Extra must be installed. 


Registers at call: Return Registers: n/a 
AH=Alh 
AL = set status byte: 

bit 7 : 0=windowed, I=enlarged 

bits 6-3: current screen profile number 0-9 

bits 2-0: active window number: 0=PC, 

{-4=host B-E, 5-6=notepad F-G 

Conflicts: "789" virus (chapter 34). 
See Also: Functions AQh and A2h 


INTERRUPT 21h - Function A2h 
SET HOST WINDOW STATE 


Purpose: Specify the state of the specified window as known to the host, 


Available on: All machines. Restrictions: Attachmate Extra must be installed, 
Registers at call: Return Registers: n/a 
AH = A2h 


AL = set status byte: 

bit 7 : O=power off, 1=power on 

bit 6 : O=not installed, 1=installed 

bits 5-3: reserved 

bits 2-0: window number: 1-4=host B-E 
Conflicts: None known. 
See Also: Function Alh 


INTERRUPT 21h - Function A3h 
SEND KEYSTROKES TO HOST WINDOW 


Purpose: Fake user input. 


Available on: All machines. Restrictions: Attachmate Extra must be installed. 
Registers at call: Return Registers: 
AH = A3h CX = zero if character sent, non-zero if not 


AL = window number (1-4=host B-E) BX incremented if CX=0 


| 
1 
H 
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CX = 0001h 
DS:BX -> keystroke buffer 
DL = zero if keystroke buffer contains host function 
code, 
non-zero if keystroke buffer contains ASCII 
character 
Conflicts: None known. 


Table 26-3. Values for Host Function Code: 














O0h=reserved Oh=PF16 20h=Clear 30h=SysRq 
Olh=PFI lh=PF17 21h=Print 31h=ErInp 
02h=PF2 12h=PF18 22h=Left 32h=ErEof 
03h=PF3 13h=PF19 23h=Right 33h=Ident 
O4h=PF4 14h=PF20 24h=Up 34h=Test 
OSh=PF5 Sh=PF21 25h=Down 35h=Reset 
O6h=PF6 6h=PF22 26h=Home 36h=DevCnel 
O7h=PF7 Th=PF23 27h=Fast Left 37h=Dup 
O8h=PF8 18h=PF26 28h=Fast Right 38h=FidMark 
O09h=PF9 Sh=Alt on 29h=Bksp 39h=Enter 
OAh=PF10 Ah=Alt off 2Ah=Insert 3Ah=CrSel 
OBh=PFI 1 iBh=Shift on 2Bh=Delete 
OCh=PF12 1Ch=Shift off 2Ch=Backtab 
ODh=PF13 Dh=PA1 2Dh=Tab 
OEh=PF14 Eh=PA2 2Eh=Newline 
OFh=PF15 Fh=PA3 2Fh=Attn 

INTERRUPT 21h - Function Adh 

GET HOST WINDOW BUFFER ADDRESS 

Purpose: Determine the address of the virtual screen for the specified window. 





Restrictions: Attachmate Extra must be installed. 
Return Registers: 
DS:BX -> 3270 display buffer 


Available on: All machines. 
Registers at call: 

AH = A4h 

AL = window number (1-4=host B-E) 
Conflicts: None known. 

See Also: Functions A5h and B8h 


INTERRUPT 21h - Function A5h 
GET HOST WINDOW CURSOR POSITION 


Purpose: Determine the current cursor position in the specified window. 

Available on: All machines. Restrictions: Attachmate Extra must be installed. 
Registers at call: Return Registers: 

AH = ASh BX = cursor position 

AL = window number (1-4=host B-E) (80 * row + column, where 0:0 is upper left) 
Details: If the host window is configured with the Extended Attribute (EAB) feature, multiply the cursor position by 
2 to obtain the byte offset into the display buffer. 

Conflicts: "Eddie-2" virus (chapter 34). 

See Also: Function A4h 


INTERRUPT 21h - Function AFh 
GET TRANSLATE TABLE ADDRESS 


Purpose: Determine the address of a table for translating between ASCII, EBCDIC, and 3270 buffer codes. 
Available on: All machines. Restrictions: Attachmate Extra must be installed. 
Registers at call: Return Registers: 

AH = AFh DS:BX -> translate tables 
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Conflicts: None known, 


Table 26-4. Format of Translate Tables: 


Offset Size Description 

00h 256 BYTEs ASCII to 3270 buffer code translate table 
100h 256 BYTEs 3270 buffer code to ASCII translate table 
200h 256 BYTEs 3270 buffer code to EBCDIC translate table 
300h 256 BYTEs EBCDIC to 3270 buffer code translate table 


INTERRUPT 21h - Function B8h 
Attachmate Extra - DISABLE HOST BUFFER UPDATES 


Purpose: Temporarily halt screen updates from the host to avoid changes while manipulating the screen memory. 


Available on: All machines. Restrictions: Attachmate Extra must be installed. 
Registers at call: Return Registers: n/a 

AH = B8h 

AL = window number (1-4=host B-E) 

DL =0th 


Details: Only valid in CUT mode. Next AID keystroke (¢.g., Enter) enables host buffer updates. 
Conflicts: Novell Advanced NetWare (chapter 20). 
See Also: Function A¢h 


INTERRUPT 2Ah - Function 90h 


Unknown Function 

Purpose: unknown, 

Available on; All machines, Restrictions: IBM PC3270 Emulation program must 
be installed. 

Registers at call: Return Registers: unknown. 

AH = 90h 

Others, if any, unknown. 

Conflicts: None known, 

INTERRUPT 2Fh - Function B4h, Subfunction 00h 

INSTALLATION CHECK 

Purpose: Determine whether version 3.0 or higher of the 13M PC3270 Emulation Program is installed. 

Available on: All machines, Restrictions: none. 

Registers at call: Return Registers: 

AX = B400h AL = FFh if installed 

Conflicts: None known. 

INTERRUPT 2Fh - Function B4h, Subfunction 01h 

GET HOST BUFFER ADDRESS 

Purpose: Determine the address of the screen memory used by the 3270 emulator. 

Available on: All machines. Restrictions: IBM PC3270 Emulation program 
version 3.0 or higher must be installed. 

Registers at call: Return Registers: 

AX = Bath ES -> host screen buffer (PC ASCII format) 


ES unchanged if communications not started 
Conflicts: None known. 


INTERRUPT 2Fh - Function B4h, Subfunction 02h 


Unknown Function 
Purpose: unknown. 
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Available on: All machines. Restrictions; IBM PC3270 Emulation program 
version 3.0 or higher must be installed. 

Registers at call: Return Registers: unknown. 

AX = B402h 


BX = unknown. 
Conflicts: None known. 


INTERRUPT 2Fh - Function B4h, Subfunctions 03h to 05h 





Unknown Functions 

Purpose: unknown. 

Available on: All machines. Restrictions: IBM PC3270 Emulation program 
version 3.0 or higher must be installed, 

Registers at call: Return Registers: unknown. 

AX = B403h to B405h 

Others, if any, unknown, 

Conflicts: None known. 

INTERRUPT 44h 

IBM 3270-PC High Level Language API 

Purpose: Provides an interface to the IBM 3270-PC emulator. 

Available on: All machines. Restrictions: IBM PC3270 Emulation program must 
be installed. 

Registers at call: Return Registers: n/a 


DS:SI -> parameter control block 
Conflicts: PCjr character font vector(chapter 5), Novell Netware HLL API (chapter 20), Z100 master 8259 (chapter 
2). 


INTERRUPT 60h 
Tangram Arbiter - API 


Purpose: Provides interface to Arbiter functions. 

Available on: All machines. Restrictions: Arbiter software must be installed. 
Details: Arbiter may use any interrupt from 60h to 66h (parameterized). The actual interrupt used is identified by the 
string "@ARB_API" immediately following a short jump at the interrupt handler’s address. Arbiter makes a PC disk 
look like a slow mainframe disk over an SNA link to an IBM mainframe. 

Conflicts: See chapter 1. 


INTERRUPT 61h 

Sangoma CCIP INTERFACE 

Purpose: Provide access to the CCPOP module's functions. 

Available on: All machines. Restrictions: Sangoma CCPOP 3270 resident module 
must be installed. 

Registers at call: Return Registers: n/a 


BX:DX -> control block 
Conflicts: See chapter 1. 


INTERRUPT 67h 

Sangoma CCPOP 3276 resident module 

Purpose: unknown, 

Available on: All machines, Restrictions: Sangoma CCPOP 3270 resident module 
must be installed. 

Conflicts: EMS (chapter 10), Alloy NTNX (chapter 18), PC-NET (chapter 27). 
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INTERRUPT 68h 
Sangoma CCPOP 3270 resident module 


Purpose: unknown. 
Available on: All machines. Restrictions: Sangoma CCPOP 3270 resident module 


must be installed. 
Conflicts: APPC/PC (chapter 25). 


INTERRUPT 7Ah - Function 04h 
1BM 3270 Workstation Program AP! - CREATE A QUEUE 


Purpose: Initiate a new queue for unknown uses. 


Available on: All machines. Restrictions: IBM 3270 Workstation Program must be 
installed. 

Registers at call: Return Registers: unknown. 

AH = 04h 


others, if any, unknown, 
Conflicts: Novell NetWare Low-level API (chapter 20), Topware Network Operating System (chapter 27), 


AutoCAD Device Interface (chapter 36). 
See Also: Function 06h 


INTERRUPT 7Ah - Function 06h 
IBM 3270 Workstation Program API- DELETE A QUEUE 


Purpose: Erase a previously-created queue and return its resources to the system. 


Available on: All machines. Restrictions: IBM 3270 Workstation Program must be 
installed, 

Registers at call: Return Registers: unknown. 

AH = 06h 


others, if any, unknown. 

Conflicts: Novell NetWare Low-level API (chapter 20), Topware Network Operating System (chapter 27), 
AutoCAD Device Interface (chapter 36). 

See Also: Function 04h 


INTERRUPT 7Ah - Function 09h 
IBM 3270 Workstation Program API - SESSION SERVICES 
Purpose: Manipulate a connection with the mainframe host. 
Available on: All machines. Restrictions: IBM 3270 Workstation Program must be 
installed. 
Registers at call: Return Registers: unknown. 
AH = 09h 
BX = 8020h (synchronous request) 
CX = 0000h 
DX = ID of session manager (SESSMGR) 
AL = service 
Oh get session ID 
02h get session info 
04h dettach from session 
05h attach to session 
06h get list of windows available 
07h get environment of window 
O8h get 'PIF' (program information file) info 
OAh get base window ID 
OBh get cursor info 
ES:DI -> control block 





i 
| 
| 
i 
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Conflicts: Novell NetWare Low-level API (chapter 20), Topware Network Operating System (chapter 27), 
AutoCAD Device Interface (chapter 36). 


INTERRUPT 7Ah - Function 09h 


KEYBOARD SERVICES 

Purpose: Manipulate the state of the keyboard as seen by the host mainframe. 

Available on: All machines. Restrictions: IBM 3270 Workstation Program must be 
installed. 

Registers at call: Return Registers: unknown. 

AH = 09h 

BX = 8020h (synchronous request) 

CX = 0000h 


DX = ID of keyboard manager 
AL = service 
Oth connect to keyboard 
02h disconnect from keyboard 
03h read from keyboard 
04h send keystroke to session 
OSh disable input 
06h enable input 
07h update status code 
ES:DI -> control block 
Conflicts: Novell NetWare Low-level API (chapter 20), Topware Network Operating System (chapter 27), 
AutoCAD Device Interface (chapter 36). 


INTERRUPT 7Ah - Function 09h 


WINDOW SERVICES 

Purpose: Manipulate windows on the screen. 

Available on: All machines. Restrictions: IBM 3270 Workstation Program must be 
installed. 

Registers at call: Return Registers: unknown. 

AH = 09h 


AL = service (see Table 26-5) 

BX = 8020h (synchronous request) 

CX = 0OFFh ' 
DX = ID of window service controller (WSCTRL) 

ES:DI -> control block 

Conflicts: Novell NetWare Low-level API (chapter 20), Topware Network Operating System (chapter 27), 
AutoCAD Device Interface (chapter 36). 


Table 26-5. 3270 Workstation API Service Codes 


Code Meaning Code Meaning 
Olh connect to WS control OAh change screen background 
02h disconnect from WS control color 
03h add a window OBh get window's position on 
04h change window's position on screen 
screen 0Ch get window's size 
05h change window's size ODh get window's color 
06h change window's color OEh get window's position in the 
07h change window's position in the presentation space 
presentation space OFh determine whether hidden 
08h hide/unhide toggle 10h determine whether enlarged 


09h enlarge/reduce toggle Th get background color 
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Table 26-5. 3270 Workstation API Service Codes (continued) 


Code Meaning Code Meaning 
12h get window names 17h delete a window from profile 
13h delete all windows from profile 18h get active window 
14h pick active window 19h get active screen 
15h redraw screen TAh get window data 
16h redraw window 1Bh change window data 
1Ch select active screen 


INTERRUPT 7Ah - Function 09h 
PRESENTATION SPACE SERVICES 
Purpose: Manipulate presentation spaces. 
Available on: All machines. Restrictions: IBM 3270 Workstation Program must be 
installed. 
Registers at call: Return Registers: unknown. 
AH = 09h 
BX = 8020h 
CX = OOFFh 
DX = ID of PCPSM 
AL = service 
Oth define presentation space 
02h delete presentation space 
03h display presentation space 
04h position cursor in presentation space 
05h change default presentation space 
ES:DI -> control block 
Conflicts; Novell NétWare Low-level API (chapter 20), Topware Network Operating System (chapter 27), 
AutoCAD Device Interface (chapter 36). 


INTERRUPT 7Ah - Function 09h 
3270 EMULATION 
Purpose: Specify whether to connect or disconnect from the mainframe host. 
Available on: All machines. Restrictions: IBM 3270 Workstation Program must be 
installed. 
Registers at call: Return Registers: unknown. 
AH = 09h 
BX = 8020h 
CX = 00FFh 
DX = ID of 3270EML 
AL = service: 
Olh connect 
02h disconnect 
ES:DI -> control block 
Conflicts: Novell NetWare Low-level API (chapter 20), Topware Network Operating System (chapter 27), 
AutoCAD Device Interface (chapter 36). 


INTERRUPT 7Ah - Function 09h 
OPERATOR INFORMATION AREA 


Purpose: Determine the contents of the 25th line on the Host session. 


Available on: All machines. Restrictions: IBM 3270 Workstation Program must be 
installed. 
Registers at call: Return Registers: unknown. 


AH = 09h 
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BX = 8020h 
CX = OOFFh 
DX = ID of OIAM 
AL = service 
Olh read Operator Information Area 
02h read OIA subset 
ES:DI -> control block 
Conflicts: Novell NetWare Low-level API (chapter 20), Topware Network Operating System (chapter 27), 
AutoCAD Device Interface (chapter 36). 


INTERRUPT 7Ah - Function 09h 
TRANSLATE DATA 


Purpose: Convert data between ASCII and the host mainframe's character set. 
Available on: All machines, Restrictions: IBM 3270 Workstation Program must be 
installed. 
Registers at call: Return Registers: unknown, 
AH =09h 
BX = 8020h 
CX = 00FFh 
DX = ID of XLATE 
AL = service 
O1h translate from host characters to ASCII and 
vice versa (determined by control block 
byte 11) 
ES:DI -> control block 
Conflicts: Novell NetWare Low-level API (chapter 20), Topware Network Operating System (chapter 27), 
AutoCAD Device Interface (chapter 36). 


INTERRUPT 7Ah - Function 09h 
COPY SERVICE 


Purpose: Copy data between presentation spaces. 
Available on: All machines. Restrictions: IBM 3270 Workstation Program must be 
installed. 
Registers at call: Return Registers: unknown. 
AH = 09h 
BX = 8020h 
CX = OOFFh 
DX = ID of copy service 
AL = service 
O1h copy string from one presentation space to 
another 
02h copy block from one presentation space to 
another 
03h connect to PC session for copy 
O4h disconnect PC session from copy 
ES:DI -> control block 
Conflicts: Novell NetWare Low-level API (chapter 20), Topware Network Operating System (chapter 27), 
AutoCAD Device Interface (chapter 36). 


INTERRUPT 7Ah - Function 09h 
MultiDOS 


Purpose: Get environment size or perform DOS memory allocation functions. 
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Restrictions: IBM 3270 Workstation Program must be 
installed. 
Return Registers: unknown. 


Available on: All machines. 


Registers at call: 
AH = 09h 
BX = 8020h 
CX = OOFFh 
ES:DI -> control block 
DX = ID of INDJQRY (get environment size) 
= ID of INDJASY (request DOS functions from 
workstation) 
= 1D of MEMORY 
AL = function 
Olh allocate memory 
02h deallocate memory 
03h modify allocated size 
Conflicts: Novell NetWare Low-level API (chapter 20), Topware Network Operating System (chapter 27), 


AutoCAD Device Interface (chapter 36). 
INTERRUPT 7Ah - Function 09h 


HOST SERVICES 

Purpose: Control connection to host mainframe or transfer data between PC and host. 

Available on: All machines. Restrictions: IBM 3270 Workstation Program must be 
installed. 

Registers at call: Return Registers: n/a 

AH = 09h 


BX = 4000h for asyne request, 8028h for 
synchronous request 

CX = 0000h 

DX = ID of MFIC 

AL = service 
01h connect to host 
02h disconnect from host 
03h read DFT structured data from host 
04h write DFT structured data to host 
O5h create a host buffer 

ES:DI -> contro! block 

Conflicts: Novell NetWare Low-level API (chapter 20), Topware Network Operating System (chapter 27), 

AutoCAD Device Interface (chapter 36). 


INTERRUPT 7Ah - Function 13h 


GET DATA FROM A QUEUE 

Purpose: Determine the contents of a queue. 

Available on: All machines. Restrictions: IBM 3270 Workstation Program must be 
installed. 

Registers at call: Return Registers: unknown. 

AH = 13h 


others, if any, unknown. 
Conflicts: Novell NetWare Low-level API (chapter 20), Topware Network Operating System (chapter 27), 


AutoCAD Device Interface (chapter 36). 


INTERRUPT 7Ah - Function 81h 
RESOLVE A GATE NAME 


Purpose: Determine the identifier corresponding to the name of a service. 
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Available on: All machines. Restrictions: IBM 3270 Workstation Program must be 
installed. 

Registers at call: Return Registers: 

AH= 81h DX = gate ID 


ES:DI -> 8-char blank-padded gate name: 

"SESSMGR ", "KEYBOARD", "WSCTRL ", 

"MFIC ","PCPSM ", "3270EML ", 

"COPY ","XLATE ","OIAM ", 

"MEMORY ","INDJIQRY ", or “INDJASY " 
Conflicts: Novell NetWare Low-level API (chapter 20), Topware Network Operating System (chapter 27) 
AutoCAD Device Interface (chapter 36). 


INTERRUPT 7Ah - Function 83h 


GET COMPLETION RESULTS 

Purpose: Determine the status of an operation. 

Available on: All machines. Restrictions: IBM 3270 Workstation Program must be 
installed. 

Registers at call: Return Registers: unknown. 

AH = 83h 


others, if any, unknown. 
Conflicts: Novell NetWare Low-level API (chapter 20), Topware Network Operating System (chapter 27), 
AutoCAD Device Interface (chapter 36). 


INTERRUPT 7h - Function FDh, Subfunction CBh 


INSTALLATION CHECK 

Purpose: Determine whether the IBM Personal Communications/3270 (PC3270) program is installed. 
Available on: All machines. Restrictions: none. 

Registers at call: Return Registers: 

AX = FDCBh DX:AX -> PCS/3270 signature block if loaded 


(Table 26-6) 
Conflicts: Novell NetWare Low-level API (chapter 20), Topware Network Operating System (chapter 27), 
AutoCAD Device Interface (chapter 36). 


Table 26-6. Format of signature block: 


Offset Size Description 
04h WORD PCS/3270 signature (574 1h) : 
06h WORD version (0501h = PCS/3270 v1.0) 


INTERRUPT 7Ah - Function FEh, Subfunction 01h 
INTERNAL SEND/RECEIVE FUNCTION 


Purpose: Called internally for data transfer. 


Available on: All machines. Restrictions: IBM PC3270 Emulator Program version 
3.0 or higher must be installed. 

Registers at call: Return Registers: unknown. 

AX = FEO1h 


others, if any, unknown. 

Conflicts: Novell NetWare Low-level API (chapter 20), Topware Network Operating System (chapter 27), 
AutoCAD Device Interface (chapter 36). 

See Also: Function FEh Subfunction 02h 
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INTERRUPT 7Ah - Function FEh, Subfunction 02h 
INTERNAL SEND/RECEIVE FUNCTION 


Purpose: Called internally for data transfer. 


Available on: All machines. Restrictions: IBM PC3270 Emulator Program version 
3.0 or higher must be installed. 

Registers at call: Return Registers: unknown. 

AX = FEO2h 


others, if any, unknown. 
Conflicts; Novell NetWare Low-level API (chapter 20), Topware Network Operating System {chapter 27), 


AutoCAD Device Interface (chapter 36). 
See Also: Function FEh Subfunction 01h 


INTERRUPT 7Ah - Function FFh, Subfunction 01h 
INTERNAL API INITIALIZATION 


Purpose: Called internally at startup. 


Available on: All machines. Restrictions: IBM PC3270 Emulator Program version 
3.0 or higher must be installed. 

Registers at call: Return Registers: 

AX = FFOIh CX = 1200h 


ES:D] -> API function handler routine 

Conflicts: Novell NetWare Low-level API (chapter 20), Topware Network Operating System (chapter 27), 
AutoCAD Device Interface (chapter 36). 

See Also: Function FFh Subfunctions 02h and 03h 


INTERRUPT 7Ah - Function FFh, Subfunction 02h 
INTERNAL API TERMINATION 


Purpose: Called internally when the PC3270 emulator is shut down. 


Available on: All machines. Restrictions: IBM PC3270 Emulator Program version 
3.0 or higher must be installed. 

Registers at call: Return Registers: 

AX = FFO2h CX = 1200h 


Conflicts; Novell NetWare Low-level API (chapter 20), Topware Network Operating System (chapter 27), 
AutoCAD Device Interface (chapter 36). 
See Also: Function FFh Subfunction 01h 


INTERRUPT 7Ah - Function FFh, Subfunction 03h 
INTERNAL API INITIALIZATION 


Purpose: Called internally at startup. 


Available on: All machines, Restrictions: IBM PC3270 Emulator Program version 
3.0 or higher must be installed. 

Registers at call: Return Registers: 

AX = FFO3h CX = 1200h 


ES:DI -> send/receive function handler routine 

Conflicts: Novell NetWare Low-level API (chapter 20), Topware Network Operating System (chapter 27), 
AutoCAD Device Interface (chapter 36). 

See Also: Function FFh Subfunction Oth 


INTERRUPT 7Ah - Function FFh, Subfunction 04h 


Unknown Internal Function 


Purpose: unknown. 
Available on: All machines. Restrictions: IBM PC3270 Emulator Program version 
3.0 or higher must be installed. 
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Registers at call: 
AX = FFO4h 
ES:DI -> unknown. 
Conflicts: Novell NetWare Low-level API (chapter 20), Topware Network Operating System (chapter 27), 
AutoCAD Device Interface (chapter 36). 


INTERRUPT 7Bh 


Eicon Access API (3270/5250 gateways) 


Purpose: Communicate with the Access program. 
Available on: All machines, 
Conflicts: Btrieve API (chapter 36). 


INTERRUPT 7Fh - Function 01h, Subfunction 04h 


Return Registers: 
CX = 1200h 


Restrictions: Eicon Access program must be installed. 


HLLAPI (IBM 


9270 High-Level Language API) 


Purpose: Provide access to 3270 emulator services. 
Available on: All machines. 


Restrictions: HLLAPI function must be installed. 


Registers at call: Return Registers: 
AX = 0104h (HLLAPI gate ID) parameter control block updated 
BX = 0000h 


DS:SI -> parameter control block (Table 26-7) 
Conflicts: Halo88 API (chapter 5), Alloy NTNX, MW386 (chapter 18), ClusterShare access (chapter 25). 


Table 26-7. Format of Parameter Control Block: 


Offset Size Description 

00h 3BYTEs _ signature = 'PCB' 

03h BYTE function number (Table 26-8) 

04h WORD segment of control string 

06h WORD offset of control string 

O8h WORD length of control string, unless explicit end-of-str char set 
OAh BYTE unused 

OBh WORD return code 

0ODh WORD maximum length of control string 


Table 26-8. Values for Function Number: 





Value Significance Value Significance 

00h Query system (Attachmate OBh Lock current presentation space 
implementation only) 0Ch Unlock previously locked presentation 

Olh Connect presentation space space 

02h Disconnect presentation space ODh Return copy of operator info area 

03h Send string of keystrokes as if typed (OIA) of current presentation space 
from keyboard OEh get attribute byte for given position in 

04h Wait ~60s, returns status of the current presentation space 
presentation space OFh copy string of characters to the current 

05h Copy current presentation space into a presentation space 
user-defined buffer 10h workstation control functions 

OGh Search presentation space for first 1th storage manager functions, intended 
occurrence of a specified string primarily for BASIC applications 

07h Query cursor location in current 12h set delay period in half-second. 
presentation space intervals 

08h Copy part or all of current presentation 14h get info on level of workstation 
space into user buffer support used 

09h Set session parameters; parameters iSh reset session parameters to default 
vary by vendor values 

OAh Get info on sessions currently 16h get detailed info on the current session 


connected 





Table 26-8. Values for Function Number (continued) 


Value Significance 
17h start host notification to application on 
presentation sp or OJA update 
18h check host update when host 
notification enabled 
19h stop host notification 
1Eh search field within current presentation 
space for string 
1Fh get first positionof a selected field in 
the current presentation space 
20h get length of specified field 
21h copy string into a specified field 
22h copy specified field into a user-defined 
buffer 
23h create alternate presentation space 
(IBM only), don't use with BASIC 
24h switch to alternate presentation space 


(IBM only), not with BASIC 


Table 26-9. Values of Session Parameters for function 09h: 


Value Significance 

ATTRIB return attributes in hex 

NOATTRIB return attributes as blanks 

CONPHYS make physical connection 

CONLOG _ only make logical connection 

EAB copy extended attribute bytes along 
with data 

NOEAB copy data only 

ESC=n set escape character to "n" (default 


EOT=n see of string character (default 


FPAUSE _ full-duration pause 

IPAUSE _ interruptible pause 

STRLEN use explicit string lengths 
STREOT use terminated strings 
SRCHALL search entire presentation space 
SRCHFRO search from specified offset 
SRCHFRW search forward from position | 
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Value Significance 

25h display cursor in specified area (IBM only), 
don't use with BASIC 

26h display alternate presentation space (IBM 
only), don't use with BASIC 

27h delete alternate presentation space (IBM 
only), don't use with BASIC 

32h start intercepting keystrokes to allow 
filtering 

33h get keystrokes after turning on interception 

34h notify operator when keystroke rejected by 
filter subroutine 

35h stop intercepting keystrokes 

5Ah send file 

5Bh receive file 

5Ch run a program 

5Dh execute DOS command 

63h change presentation space position to PC 
display row/col or vice versa 

FFh Get info on DCA implementation 

Value Significance 

SRCHBKWD search backward from last position 


in presentation space 

TWAIT wait specified time for keyboard ready 

LWAIT wait until keyboard ready 

NWAIT no wait 

TRON enable tracing 

TROFF disable tracing 

AUTORESE, ae reset before sending keys with function 

NORESET don't send reset 

QUIET don't display messages sent with INT 
2HAH=9 

NOQUIET allow messages to be displayed 

TIMEOUT=set timeout in 30-second intervals, 0 = wait 
until Break 

XLATE translate extended attribute bytes 

NOXLATE don't translate 

NEWRET — use HLLAPI v3.0 return code conventions 

OLDRET — use HLLAPI v2.0 return code conventions 
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Miscellaneous Networking Calls 


This chapter contains all those network-related functions which do not have their own chapter. Such diverse products 
as Shamrock Software’s EMAIL and NET.24, NetBIOS, LAN Manager, and the IBM Token Ring are covered here. 


INTERRUPT 16h - Function 45h, Subfunction 00h 
GET STATUS 


Purpose: Determine EMAIL version and the current user’s 
Available on: All machines. 


Registers at call: 

AX = 4500h 

DL = port number (01h = COM1) 

ES:BX - > 13-byte buffer for ASCIZ name 


Conflicts: None known. 
See Also: Function 45h Subfunctions 01h and 02h 


INTERRUPT 16h - Function 45h, Subfunction 01h 
GET ELAPSED ONLINE TIME AND MAXIMUM TIME 


name and privileges. 
Restrictions: Shamrock Software EMAIL must be 
installed, 
Return Registers: 
AX = 4D00h if EMAIL installed on specified port 
ES:BX -> "" if no connection 
-> "*" if connection but caller has not identified 
name 
- > name otherwise 
CX = version (CH = major, CL = minor) 
DL = privilege level of user (00h = guest) 
DH = chosen language (00h German, 01h English) 


Purpose: Determine how long the current user has been connected and the maximum length of time he is allowed. 


Available on: All machines. 


Registers at call: 
AX =4501h 
DL = port number (01h = COM1) 


Conflicts: None known, 
See Also: Function 45h Subfunction 00h 


INTERRUPT 16h - Function 45h, Subfunction 02h 
GET CURRENT COMMUNICATIONS PARAMETERS 


Restrictions: Shamrock Software EMAIL must be 
installed, 

Return Registers: 

AX = 4D00h if EMAIL installed on specified port 

BX = maximum connect time in clock ticks 

CX = maximum connect time for guests (without 
name) in clock ticks 

DX = elapsed connect time of current user in clock 
ticks 


Purpose: Determine the current serial port parameters and communications options. 


Available on: All machines. 


Restrictions: Shamrock Software EMAIL must be 
installed. 
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Registers at cali: Return Registers: 
AX = 4502h AX = 4D00h if EMAIL installed on specified port 
DL = port number (01h = COM1) BL = current value of serial port's Line Control 
Register (see chapter 7) 
BH = flags 
bit 0: ISO code 
1; pause 
2: linefeed 


3: ANSI sequences 
CX = selected country code (33 = France, 49 = 
Germany, etc) 
DX = baudrate divisor (115200/DX = baudrate) 
Conflicts: None known. 
See Also: Function 45h Subfunction 00h 


INTERRUPT 16h - Function 45h, Subfunction 03h 
SPECIFY COMMAND-WORD FOR USER FUNCTION 


Purpose: Store a keyword which may be used to invoke a user function extending the standard command set, 


Available on: All machines. Restrictions: Shamrock Software EMAIL must be 
installed. 

Registers at call: Return Registers: 

AX = 4503h AX = 4D00h if EMAIL installed on specified port 


DL = port number (01h = COM1) 
DH = maximum execution time in clock ticks 
(00h = 5 seconds) 
ES:BX -> ASCIZ string with new user command- 
word 
Details: A single user command (consisting of only uppercase letters and digits) may be defined, and remains valid 
until it is overwritten or the EMAIL program terminates; the user command must be activated by calling Function 
45h Subfunction 04h at least once. This function may be used to redefine an existing command word. 
Conflicts: None known. 
See Also: Function 45h Subfunctions 04h and 05h 


INTERRUPT 16h - Function 45h, Subfunction 04h : 
CHECK FOR USER FUNCTION COMMAND-WORD ' 


Purpose: Determine whether the user has entered a command beginning with the previously stored keyword. 


Available on: All machines. Restrictions: Shamrock Software EMAIL must be 
installed. 

Registers at call: Return Registers: 

AX = 4504h AX = 4D00h if EMAIL installed on specified port 

DL = port number (01h = COM1) DL = flags 

ES:BX -> 80-byte buffer for ASCIZ user input line bit 0: user function supported (always set) 


I: user entered user-function command word 
if DL bit 1 set, ES:BX buffer contains line entered 
by user which begins with the defined 
command word and has been converted to all 
caps 
Details: The caller must process the returned commandline and invoke Function 45h Subfunction 05h within five 
seconds with the result of that processing, or the user function will be timed out. 
Conflicts: None known. 
See Also: Function 45h Subfunctions 03h and 05h 
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INTERRUPT 16h - Function 45h, Subfunction 05h 
SEND RESULT OF USER FUNCTION 


Purpose: Inform EMAIL of the result of the command set extension function, 


Available on: All machines. Restrictions: Shamrock Software EMAIL must be 
installed. 
Registers at call: Return Registers: 
AX = 4505h AH = 4Dh if EMAIL installed on specified port 
DL = port number (01h = COMI) AL = status 
DH = error flag 00h successful 
bit 3: set on error 02h unable to perform function (timeout, prev call 
ES:BX -> ASCIZ text to return to user, max 1024 not complete) 
bytes other: error 


Details: If the error flag in DH is set, the string is not sent and an error message is generated instead; if this function 
is not called within five seconds of Function 45h Subfunction 04h, EMAIL automatically generates an error 
message. 

The string is copied into an internal buffer, allowing this function's caller to continue immediately. 
Conflicts: None known. 
See Also: Function 45h Subfunctions 03h and 04h, INT 17h Function 24h Subfunction 00h 


INTERRUPT 16h - Function 45h, Subfunction 06h 
MONITOR XMODEM DOWNLOAD 


Purpose: Determine whether an XMODEM download is in progress or whether one has successfully completed. 


Available on: All machines, Restrictions: Shamrock Software EMAIL must be 
installed. 
Registers at call: Return Registers: 
AX = 4506h AX = 4D00h if EMAIL installed on specified port 
DL = port number (Oth = COM1) DH = Xmodem status 
ES:BX -> 13-byte buffer for ASCIZ filename 00h no XGET command given 
Olh XGET in progress 


02h XGET completed successfully 
ES:BX buffer filled with last filename given to XGET 
command (without path) 
Details: DH=02h will only be returned once per XGET; subsequent calls will return DH=00h. 
Conflicts: None known. 
See Also: Function 45h Subfunction 00h, INT 17h Function 24h Subfunction 08h 


INTERRUPT 17h - Function 24h, Subfunction 00h 
ENABLE/DISABLE API FUNCTIONS 


Purpose: Specify whether the other NET.24 functions should be accessible, and return the current status. 


Available on: All machines. Restrictions: Shamrock Software NET.24 version 
3.11 or higher must be installed. 
Registers at call: Return Registers: 
AX = 2400h DL = 24h if installed 
DL = new state DH = minor version number 
00h disabled CX = network address of this machine 
Oth enabled AL & status 
00h successful 
O1h timeout 


02h header error 

03h data error 

04h busy 

O5h invalid parameters 
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Conflicts: None known. 
See Also: Function 24h Subfunction 03h, INT 16h Function 45h Subfunction 00h 


INTERRUPT 17h - Function 24h, Subfunction Oth 
RECEIVE BLOCK, NO HANDSHAKE 


Purpose: Attempt to read a block of data without performing any handshaking. 


Available on: All machines. Restrictions: Shamrock Software NET.24 version 
3.11 or higher must be installed. 

Registers at call: Return Registers: 

AX = 2401h AL = status (see Function 24h Subfunction 00h) 

BL = timeout in clock ticks DX:BX -> receive buffer 


Conflicts: None known, 
See Also: Function 24h Subfunctions 02h, 04h, and 08h 


INTERRUPT 17h - Function 24h, Subfunction 02h 
TRANSMIT BLOCK, NO HANDSHAKE 


Purpose: Attempt to transmit a block of data without performing any handshaking. 


Available on: All machines. Restrictions: Shamrock Software NET.24 version 
3.11 or higher must be installed. 

Registers at call: Return Registers: 

AX = 2402h AL = status (see Function 24h Subfunction 00h) 

transmit buffer filled (see Function 24h Subfunction 

03h) 


Conflicts: None known. 
See Also: Function 24h Subfunctions 01h, 03h, 04h, and 09h 


INTERRUPT 17h - Function 24h, Subfunction 03h 
GET STATUS AND TRANSMISSION BUFFER 


Purpose: Determine the current status and the address of the buffer to use for transmitting data. 


Available on: All machines. Restrictions: Shamrock Software NET,.24 version 
3.11 or higher must be installed. 

Registers at call: Return Registers: 

AX = 2403h AL = status (see Function 24h Subfunction 00h) 


CX = number of characters in receive ring buffer 
DX:BX -> transmit buffer 

Conflicts: None known. 

See Also: Function 24h Subfunctions 00h and 02h 


INTERRUPT 17h - Function 24h, Subfunction 04h 


SEND ACK BLOCK 

Purpose: Acknowledge the successful receipt of a data block. 

Available on: All machines. Restrictions: Shamrock Software NET.24 version 
3.11 or higher must be installed. 

Registers at call: Return Registers: 

AX = 2404h AL = status (see Function 24h Subfunction 00h) 


BX = target address 
Conflicts: None known, 
See Also: Function 24h Subfunctions 02h and 05h 


INTERRUPT 17h - Function 24h, Subfunction 05h 
SEND NAK BLOCK 


Purpose: Indicate to the sender of a data block that it was received in error. 


Miscellaneous Networking Calls 27-5 


Available on; All machines. Restrictions: Shamrock Software NET.24 version 
3.11 or higher must be installed. 

Registers at call: Return Registers: 

AX = 2405h AL-= status (see Function 24h Subfunction 00h) 


BX = target address 
Conflicts: None known. 
See Also: Function 24h Subfunctions 02h and 04h 


INTERRUPT 17h - Function 24h, Subfunction 06h 
PREPARE CHARACTER-ORIENTED RECEIVE 


Purpose: Indicate to NET.24 that the caller will be performing character-by-character input over the network, 


Available on: All machines. Restrictions: Shamrock Software NET.24 version 
3.11 or higher must be installed. 

Registers at call: Return Registers: 

AX = 2406h AL = status (see Function 24h Subfunction 00h) 


Conflicts: None known, 
See Also: Function 24h Subfunctions 07h and OAh 


INTERRUPT 17h - Function 24h, Subfunction 07h 
RECEIVE CHARACTER FROM REMOTE 


Purpose: Retrieve the next character, if any, from another machine. 


Available on: Ali machines. Restrictions: Shamrock Software NET.24 version 
3.11 or higher must be installed. 
Registers at call: Return Registers: 
AX = 2407h AL = status (see also Function 24h Subfunction 00h) 
06h end of data 


DL = received character 
Conflicts: None known, 
See Also: Function 24h Subfunction 06h 


INTERRUPT 17h - Function 24h, Subfunction 08h 
RECEIVE BLOCK, WITH HANDSHAKE 


Purpose: Retrieve a block of data from a remote system using handshaking to ensure correct reception. 


Available on: All machines. Restrictions: Shamrock Software NET.24 version 
3.1 | or higher must be installed. 
Registers at call: Return Registers: 
AX = 2408h AL = status (see also Function 24h Subfunction 00h) 
OGh end of data 


CX = number of bytes in receive buffer 
DX:SI -> receive buffer 

Conflicts: None known. 

See Also: Function 24h Subfunctions 01h, 05h, and 09h 


INTERRUPT 17h - Function 24h, Subfunction 09h 
TRANSMIT COMMAND, WITH HANDSHAKE 


Purpose: Send a command to another system, using handshaking to ensure correct reception. 


Available on: All machines. Restrictions; Shamrock Software NET.24 version 
3.11 or higher must be installed. 

Registers at call: Return Registers: 

AX = 2409h AL = status (see also Function 24h Subfunction 00h) 

BX = target address 03h no response 


CX = number of data bytes 06h remote currently unable to perform command 
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DL = command code to send 

DS:SI -> data bytes for command 

Conflicts: None known. 

See Also: Function 24h Subfunctions 05h and 08h 


INTERRUPT 17h - Function 24h, Subfunction 0Ah 
PREPARE CHARACTER-ORIENTED TRANSMIT 


Purpose: Indicate to NET.24 that the caller will be performing character-by-character output over the network. 


Available on: All machines. Restrictions: Shamrock Software NET.24 version 
3.11 or higher must be installed. 

Registers at call: Return Registers: 

AX = 240Ah AL = status (see Function 24h Subfunction 00h) 


Conflicts: None known, 
See Also: Function 24h Subfunctions 06h, OBh, and OCh 


INTERRUPT 17h - Function 24h, Subfunction OBh 
TRANSMIT SINGLE CHARACTER TO REMOTE 


Purpose: Output a single byte over the network, 


Available on: All machines, Restrictions: Shamrock Software NET.24 version 
3.11 or higher must be installed. 

Registers at call: Return Registers: 

AX = 240Bh AL = status (see also Function 24h Subfunction 00h) 

DL = character to send 03h transmission error 


06h write error 
Conflicts: None known. 
See Also: Function 24h Subfunctions 07h, OAh, and OCh 


INTERRUPT 17h - Function 24h, Subfunction 0Ch 
END CHARACTER-ORIENTED TRANSMIT 


Purpose: Indicate to NET.24 that the caller will no longer perform character-by-character network output. 


Available on: All machines. Restrictions: Shamrock Software NET.24 version 
3.11 or higher must be installed. 

Registers at call: Return Registers: 

AX = 240Ch AL = status (see also Function 24h Subfunction 00h) 


03h transmission error 

06h remote breaks connection 
Conflicts: None known. 
See Also: Function 24h Subfunctions OAh and OBh 


INTERRUPT 21h - Function 44h, Subfunction 02h 
PROTOCOL MANAGER 


Purpose: Communicate with the Microsoft LAN Manager or compatible network software. The Network Driver 
Interface specification (currently at version 2.0.1) was developed by Microsoft and 3com. 


Available on: All machines. Restrictions: NDIS 2.0.1-conformant network driver 
must be installed, 

Registers at call: Return Registers: n/a 

AX = 4402h 


BX = file handle for device "PROTMAN$" 

CX = QO0Eh (size of request block) 

DS:DX -> request block (see Tables 27-2 thru 27- 

11) 

Conflicts; DOS IOCTL Read (chapter 8), IBM System 36/38 Workstation Emulation - VDIL.SYS (chapter 26), 
HIGHUMM.SYS (chapter 36). 


Table 27-1. Values of Status Codes for NDIS: 


Value 
0000h 
0001 





0021h 


Meaning 

success 

wait for release--protocol has retained 
control of the data buffer 
request queued 

frame not recognized 
frame rejected 

frame should be forwarded 
out of resource 

invalid parameter 

invalid function 

not supported 

hardware error 

transmit error 
unrecognized destination 
buffer too small 

already started 

binding incomplete 
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Value Meaning 

0022h driver not initialized 
0023) hardware not found 
0024h hardware failure 
0025h configuration failure 
00261 interrupt conflict 


i 
0027h MAC incompatible 
a 


0028! initialization failed 

0029h no binding 

002Ah network may be disconnected 
002Bh incompatible OS version 


002Ch already registered 

002Dh path not found 

002Eh insufficient memory 

002Fh info not found 

OOFFh general failure 

FOOOh-FFFFh reserved for vendor-specific codes, 
treated as general failure 





Table 27-2. Format of Request Block for GetProtocolManagerInfo: 


Offset 
00h 
02h 
04h 
08h 
0Ch 


Size Description 
WORD  Olh 


WORD returned status (see Table 27-1) 

DWORD _ returned pointer to structure representing parsed user config 
DWORD — unused 

WORD returned BCD version of NDIS on which Protocol Manager is based 


Table 27-3. Format of Request Block for RegisterModule: 


Offset 
00h 
02h 
04h 
08h 
0Ch 


Size Description 

WORD 02h 

WORD returned status (see Table 27-1) 

DWORD pointer to module's common characteristics table (see below) 
DWORD _ pointer to list of modules to which the module is to be bound 
WORD unused 


Table 27-4, Format of Request Block for BindAndStart: 


Offset 
00h 
02h 
04h 
08h 
0Ch 


Size Description 

WORD 03h 

WORD returned status (see Table 27-1) 

DWORD caller's virtual address in FailingModules structure 
DWORD — unused 

WORD unused 


Table 27-5. Format of Request Block for GetProtocolManagerLinkage: 


Offset 
00h 
02h 
04h 
O8h 
0Ch 


Size Description 

WORD 04h 

WORD returned status (see Table 27-1) 
DWORD returned dispatch point 
DWORD _ unused 

WORD returned protocol manager DS 
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Details: The dispatch point may be called as follows instead of using this IOCTL: 
STACK: WORD protocol manager DS 
DWORD pointer to request block 
Return: AX = retumed status 
STACK popped 


Table 27-6. Format of Request Block ‘for GetProtocoliniPath: 


Offset Size Description 

00h WORD 05h 

02h WORD returned status (see Table 27-1) 

04h DWORD pointer to a buffer for the ASCIZ pathname of PROTOCOL.INI 
08h DWORD — unused 

0Ch WORD buffer length 


Table 27-7, Format of Request Block for RegisterProtocolManagerInfo: 


Offset Size Description 

00h WORD 06h 

02h WORD returned status (see Table 27-1) 

04h DWORD pointer to structure containing parsed user config file 
08h DWORD _ unused 

0Ch WORD length of structure 


Table 27-8. Format of Request Block for InitandRegister: 


Offset Size Description 

00h WORD 07h 

02h WORD returned status (see Table 27-1) 

04h DWORD _ unused 

08h DWORD _ poitner to ASCIZ name of the module to be prebind initialized 
0Ch WORD unused 


Table 27-9. Format of Request Block for UnbindAndStop: 


Offset Size Description 

00h WORD 08h 

02h WORD returned status (see Table 27-1) 

04h DWORD failing modules as for BindAndStart 

08h DWORD _ if not 0000h:0000h, pointer to ASCIZ name of module to unbind 


if 0000h:0000h, terminate a set of previously dynamically bound protocol modules 
0Ch WORD unused 


Table 27-10. Format of Request Block for BindStatus: 


Offset Size Description 
00h WORD 09h 
02h WORD returned status (see Table 27-1) 
04h DWORD _ must be 0000h:0000h 

on return, points to root tree 
08h DWORD —0000h:0000h 
0Ch WORD unused under DOS 


Table 27-11. Format of Request Block for RegisterStatus: 


Offset Size Description 
00h WORD OAh 
02h WORD returned status (0000h, 0008h, 002Ch) (see Table 27-1) 
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Table 27-11, Format of Request Block for RegisterStatus (continued) 


Offset 
04h 
08h 
0Ch 


Table 27-12. 


Offset 
00h 
02h 
03h 
04h 
06h 
07h 
O8h 


0Ch 
1Ch 


IDh 


{Eh 


{Fh 
20h 
22h 
24h 
28h 
2Ch 
30h 
34h 
38h 
3Ch 


Size 
DWORD 
DWORD 
WORD 


Description 

0000h:0000h 

pointer to 16-byte ASCIZ module name 
0000h 


Format of Common Characteristics Table: 


Size 
WORD 
BYTE 
BYTE 
WORD 
BYTE 
BYTE 
DWORD 


16 Bytes 
BYTE 


BYTE 


BYTE 


BYTE 
WORD 
WORD 
DWORD 
DWORD 
DWORD 
DWORD 
DWORD 
DWORD 
DWORD 


Description 
size of table in bytes 
NDIS major version 
NDIS minor version 
reserved 
module major version 
module minor version 
module function flag bits: 
bit 0: binding at upper boundary supported 
bit [: binding at lower boundary supported 
bit 2: dynamically bound 
bits 3-31 reserved, must be 0 
ASCIZ module name 
upper boundary protocol level: 
Olh Media Access Control 
02h Data link 
03h network 
04h transport 
OSh session 
FFh not specified 
upper boundary interface type: 
for MACs: | = MAC 
for data links and transports: to be defined 
for session: | = NCB 
any level: 0 = private (IS V-defined) 
lower boundary protocol level: 
00h physical 
Oth Media Access Control 
02h Data link 
03h network 
04h transport 
05h session 
FFh not specified 
lower boundary interface type, same as offset 1Dh 
module ID filled in by protocol manager 
module DS 
system request entry point 
pointer to service-specific characteristics, 0000h:0000h if none 
pointer to service-specific status, 0000h:0000h if none 
pointer to upper dispatch table (see below), 0000h:0000h if none 
pointer to lower dispatch table (see below), 0000h:0000h if none 
reserved, must be 0 
reserved, must be 0 


Details: For compatibility with NDIS 1.x.x, a major version of 00h is interpreted as OLh. 
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Table 27-13. Format of MAC Service-Specific Characteristics Table: 


Offset 
00h 
02h 


12h 
14h 
24h 
34h 
38h 
3Ch 
40h 


44h 
46h 
4Ah 
4Ch 
50h 
52h 
55h 
56h 
5Ah 
5Ch 
SEh 
60h 


Table 27-14, 


Offset 
00h 
02h 
12h 
14h 


Table 27-15. 


Offset 
00h 
02h 


Size 
WORD 
16 BYTEs 


WORD 

16 BYTEs 
16 BYTEs 
DWORD 
DWORD 
DWORD 
DWORD 


WORD 
DWORD 
WORD 
DWORD 
WORD 

3 BYTEs 
BYTE 
DWORD 
WORD 
WORD 
WORD 
N BYTEs 


Description 
length of table in bytes 
ASCIZ MAC type name, "802.3", "802.4", "802.5", "802.6", "DIX", "DIX+802.3", 
“APPLETALK", "ARCNET", "FDDI", "SDLC", "BSC", "HDLC", or "ISDN" 
length of station addresses in bytes 
permanent station address 
current station address 
current functional adapter address (00000000h if none) 
pointer to multicast address list 
link speed in bits/sec 
service flags: 
bit 0: supports broadcast 
: supports multicast 
: supports functional/group addressing 
: supports promiscuous mode 
: station address software settable 
2 statistics always current 
: supports InitiateDiagnostics 
: supports loopback 
: MAC does primarily ReceiveChain indications instead of 
ReceiveLookahead indications 
9: supports IBM source routing 
10: supports MAC reset 
11: supports Open/Close adapter 
12: supports interrupt request 
13: supports source routing bridge 
14: supports GDT virtual addresses (OS/2 version) 
15: multiple TransferDatas allowed durign a single indication 
16: MAC normally sets FrameSize = 0 in ReceiveLookahead 
17-31: reserved, must be 0 
maximum frame size which may be both sent and received 
total transmit buffer capacity in bytes 
transmit buffer allocation block size in bytes 
total receive buffer capacity in bytes 
receive buffer allocation block size in bytes 
TEEE vendor code 
vendor adapter code 
pointer to ASCIZ vendor adapter description 
IRQ used by adapter 
transmit queue depth 
maximum supported number of data blocks in buffer descriptors 
vendor-specific info 
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Format of NetBIOS Service-Specific Characteristics Table: 


Size 
WORD 

16 BYTEs 
WORD 

N BYTEs 


Description 

length of table in bytes 

ASCIZ type name of NetBIOS module 
NetBIOS module code 
vendor-specific info 


Format of MAC Service-Specific Status Table: 


Size 
WORD 
DWORD 


Description 
length of table in bytes 
seconds since 0:00 1/1/70 when diagnostics last run (FFFFFFFFh = never) 
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Table 27-15, Format of MAC Service-Specific Status Table (continued) 


Offset 
06h 


OAh 








Size 
DWORD 


WORD 


DWORD 
DWORD 
DWORD 
DWORD 
DWORD 
DWORD 
DWORD 
DWORD 
DWORD 
DWORD 
DWORD 
DWORD 
DWORD 
DWORD 
DWORD 
DWORD 
DWORD 
DWORD 
DWORD 
DWORD 
DWORD 
DWORD 
N BYTEs 


Description 
MAC status bits: 
bits 0-2; 000 hardware not installed 
001 hardware failed startup diagnostics 
010 hardware configuration problem 
O11 hardware fault 
100 operating marginally due to soft faults 
101 reserved 
110 reserved 
111 hardware fully operational 
bit 3: MAC bound 
4: MAC open 
5: diagnostics in progress 
6-31: reserved 
current packet filter flags: 


bit 0: directed/multicast or group/functional 
I: broadcast 
2: promiscuous 
3: all source routing 


4-15: reserved, must be zero 
pointer to media-specific status table or 0000h:0000h 
seconds past 0:00 1/1/70 of last ClearStatistics 
total frames received (FFFFFFFFh = not counted) 
frames with CRC error (FFFFFFFFh = not counted) 
total bytes received (FFFFFFFFh = not counted) 
frames discarded--no buffer space (FFFFFFFFh = not counted) 
multicast frames received (FFFFFFFFh = not counted) 
broadcast frames received (FFFFFFFFh = not counted) 
frames with errors (FFFFFFFFh = not counted) 
overly large frames (FFFFFFFFh = not counted) 
frames less than minimum size (FFFFFFFFh = not counted) 
multicast bytes received (FFFFFFFFh = not counted) 
broadcast bytes received (FFFFFFFFh = not counted) 
frames discarded--hardware error (FFFFFFFFh = not counted) 
total frames transmitted (FFFFFFFFh = not counted) 
total bytes transmitted (FFFFFFFEh = not counted) 
multicast frames transmitted (FRFFFFFFh = not counted) 
broadcast frames transmitted (FFFFFFFFh = not counted) 
broadcast bytes transmitted (FRFFFFFFFh = not counted) 
multicast bytes transmitted (FFFFFFFFh = not counted) 
frames not transmitted--timeout (FFFFFFFFh = not counted) 
frames not transmitted--hardware error (FFFFFFFFh = not counted) 
vendor-specific info 


INTERRUPT 21h - Function 5Fh, Subfunctions 32h through 53h 
LOCAL INTERFACE 


Purpose: Request LAN Manager enhanced services. 


Available on: All machines. 


Registers at call: 


AH = 5Fh 


AL = function 
32h DosQNnPipelnfo 
33h DosQNmPHandState 
34h DosSetNmPHandState 
35h DosPeekNmPipe 


installed. 
Return Registers: 
not known at the time of writing. 


27-14 


Restrictions: LAN Manager Enhanced DOS must be 
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36h DosTransactNmPipe 
37h DosCallNmPipe 
38h DosWaitNmPipe 
39h DosRawReadNmPipe 
3Ah DosRawWriteNmPipe 
3Bh NetHandleSetInfo 
3Ch NetHandleGetInfo 
40h NetMessageBufferSend 
42h NetServiceControl 
44h NetWkstaGetInfo 
45h NetWkstaSetInfo 
46h NetUseEnum 
47h NetUseAdd 
48h NetUseDel 
49h NetUseGetInfo 
4Ah NetRemoteCopy 
ABh NetRemoteMove 
4Ch NetServerEnum 
4Dh DosMakeMailslot 
4Eh DosDeleteMailslot 

4Fh DosMailslotinfo 

50h DosReadMailslot 

51h DosPeekMailslot 

52h DosWriteMailslot 

53h NetServerEnum2 
Other registers vary by function, 
but were not known at the time of writing. 
Conflicts: None known. 


INTERRUPT 21h - Function CFh 
LANstep 


Purpose: Control LANstep. 

Available on: All machines. Restrictions: LANstep must be installed. 
Registers at call: Return Registers: unknown. 

AH = CFh 

other unknown. 

Details: LANstep is a redesign of the Waterloo Microsystems PORT network. 

Conflicts: Novell NetWare (chapter 20). 


INTERRUPT 21h - Function FFh 





Unknown Function 

Purpose: unknown. 

Available on: All machines. Restrictions: Topware Network Operating System 
must be installed, 

Registers at call: Return Registers: wnknown. 

AH = FFh 


other unknown. 
Conflicts: "Sunday" virus, "PSQR/1720" virus, and "Ontario" virus (all in chapter 34); DJ GO32.EXE 80386+ DOS 
extender (chapter 9); and DOSED and CED (chapter 36). 


INTERRUPT 2Ah - Function 00h, Subfunction 00h 
INSTALLATION CHECK 


Purpose: Determine whether AT&T Starlan Extended NetBIOS (supporting variable-length names) is installed. 
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Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AX = 0000h AH = DDh if installed 


Conflicts: Microsoft/LANtastic NETWORK Installation Check. 
See Also: INT 5B 


INTERRUPT 2Ah - Function 00h 
INSTALLATION CHECK 


Purpose: Determine whether the alternate NetBIOS interface is present. This function is supported by Microsoft and 
LANtastic network software. 


Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AH = 00h AH <> 00h if installed 


Conflicts: AT&T Starlan Extended NetBIOS Installation Check, 
See Also: INT 5Ch 


INTERRUPT 2Ah - Function 01h 
EXECUTE NetBIOS REQUEST, NO ERROR RETRY 


Purpose: Perform a NetBIOS command, reporting whether it was successful. 





Available on: All machines. Restrictions: Microsoft or LANtastic network 
software must be installed, 

Registers at call: Return Registers: 

AH = 01h AL = NetBIOS error code 

ES:BX -> NCB (see INT 5Ch) AH = 00h if no error 


= 01h on error 
Conflicts: None known. 
See Also: Function 04h, INT SCh 


INTERRUPT 2Ah - Function 02h 


SET NET PRINTER MODE 

Purpose: Specify the mode of the redirected network printer. 

Available on: All machines, Restrictions: Microsoft network software must be 
installed. 

Registers at call: Return Registers: unknown. 

AH = 02h 

unknown. 


Conflicts: None known, 


INTERRUPT 2Ah - Function 03h, Subfunction 00h 
CHECK DIRECT /0 


Purpose: Determine whether direct disk accesses (INT [3h, INT 25h, or INT 26h) are allowed on the specified 
drive. 


Available on: All machines. Restrictions: Microsoft or LANtastic network 
software must be installed, 

Registers at call: Return Registers: 

AX = 0300h CF clear if absolute disk access allowed 


DS:SI -> ASCIZ disk device name (may be full path 
or only drive specifier--must include the colon) 
Details: Do not use direct disk accesses if this function returns CF set or the device is redirected (NT 21h Function 
5Fh Subfunction 02h, chapter 8). The call may take some time to execute. 
Conflicts: None known. 
See Also: INT 13h, INT 25h, INT 26h, INT 21h Function 5Fh Subfunction 02h (chapter 8) 
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INTERRUPT 2Ah - Function 04h 
EXECUTE NetBIOS REQUEST 


Purpose: Perform a NetBIOS command, optionally retrying the command on errors 09h, 12h, and 21h. 


Available on: All machines. Restrictions: Microsoft or LANtastic network 
software must be installed. 

Registers at call: Return Registers: 

AH = 04h AX = 0000h for no error 

AL = 00h for error retry, 01h for no retry AH = 01h, AL = error code 


ES:BX -> NCB (see INT 5Ch) 
Conflicts: None known. 
See Also: Function Oth, INT 5Ch 


INTERRUPT 2Ah - Function 05h, Subfunction 00h 
GET NETWORK RESOURCE INFORMATION 


Purpose: Determine the number of names, commands, and sessions still available. 


Available on: All machines, Restrictions: Microsoft or LANtastic network 
software must be installed. 

Registers at call: Return Registers: 

AX = 0500h AX = reserved 


BX = number of network names available 

CX = number of commands (NCBs) available 

DX = number of sessions available 
Conflicts: None known. 


INTERRUPT 2Ah - Function 06h 
NETWORK PRINT-STREAM CONTROL 


Purpose: Specify when to queue the current printer output and start a new print job. 


Available on: All machines. Restrictions: NetBIOS software must be installed. 
Registers at call: Return Registers: 
AH = 06h CF set on error 
AL = Olh set concatenation mode (all printer output AX = error code 
put in one job) CF clear if successful 


= 02h set truncation mode (default; printer 
open/close starts new print job) 
= 03h flush printer output and start new print 
job 
Details: Subfunction 03h is equivalent to Ctrl/Alt/keypad-*. 
Conflicts: None known. 
See Also: INT 21h Function 5Dh Subfunctions 08h and09h (chapter 8), INT 2Fh Function 11h Subfunction 25h 
(chapter 19) 


INTERRUPT 24h - Function 20h, Subfunctions 01h through 03h 


Unknown Functions 

Purpose: waknown, 

Available on: All machines. Restrictions: MS Networks or NetBIOS software must 
be installed. 

Registers at call: Return Registers: unknown. 


AX = 2001h to 2003h 

other unknown, 

Details: Subfunction 01h is intercepted by DESQview 2.x; Subfunctions 02h and 03h are called by MSDOS 3.30 
APPEND. 

Conflicts: None known. 
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INTERRUPT 2Ah - Function 80h 
BEGIN DOS CRITICAL SECTION 


Purpose: Called by DOS or DOS programs to indicate the beginning of uninterruptible or nonreentrant code. 


Available on: All machines. Restrictions: Microsoft-compatible network software 
must be installed. 

Registers at call: Return Registers: n/a 

AL = 80h 


AL = critical section number (00h-OFh) 

01h DOS kernel (SHARE.EXE) apparently for 
maintaining the integrity of 
DOS/SHARE/NET data structures 

02h DOS kernel, ensures that no multitasking 
occurs while DOS is calling an installable 
device driver 

05h DOS 4 IFSFUNC 

06h DOS 4 IFSFUNC 


08h ASSIGN.COM 
Details: This function is normally hooked to avoid interrupting a critical section, rather than called. The handler 


should ensure that none of the critical sections are reentered, usually by suspending a task which attempts to reenter 
an active critical section. 

The DOS kernel does not invoke critical sections 01h and 02h unless it is patched by the network software. DOS 
3.1 through 3.31 contain a zero-terminated list of words beginning at offset 02C3h in the IBMDOS segment; each 
word contains the offset within the IBMDOS segment of a byte which must be changed from C3h to 50h to enable 
the use of critical sections. 
Conflicts: None known. 
See Also: Functions 81h, 82h, and 87h; INT 21h Function 5Dh Subfunctions 06h and OBh (chapter 8) 


INTERRUPT 2Ah - Function 81h 
END DOS CRITICAL SECTION 


Purpose: Called by DOS or DOS programs to indicate the end of a section of uninterruptible or nonreentrant code. 


Available on: All machines. Restrictions: Microsoft-compatible network software 
must be installed. 

Registers at call: Return Registers: n/a 

AH = 81h 

AL = critical section number (O0h-OFh) (see 

Function 80h) 


Details: Normally hooked rather than called. The handler should reawaken any tasks which were suspended due to 
an attempt to enter the specified critical section. 

Conflicts: None known, 

See Also: Functions 80h, 82h, and 87h 


INTERRUPT 2Ah - Function 82h 
END DOS CRITICAL SECTIONS 0 THROUGH 7 


Purpose: Called by DOS to clear any critical sections which may have been left active by an aborted system call. 


Available on: All machines. Restrictions: Microsoft-compatible network software 
must be installed. 

Registers at call: Return Registers: n/a 

AH = 82h 


Details: This function is called by the INT 21h function dispatcher for function 0 and functions greater than OCh 
except 59h, and on process termination. The handler should reawaken any tasks which were suspended due to an 
attempt to enter one of the critical sections 0 through 7, 

Conflicts: None known. 
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See Also: Function 81h 
INTERRUPT 2Ah - Function 84h 
KEYBOARD BUSY LOOP 


Purpose: Called by DOS when waiting for keyboard input in order to allow the network to process requests from 
temote machines. 


Available on: All machines, Restrictions: Microsoft-compatible network software 
must be installed. 

Registers at call: Return Registers: n/a 

AH = 84h 


Details: This call is similar to DOS's INT 28h. 
Conflicts: None known. 
See Also: INT 28h 


INTERRUPT 2Ah - Function 87h 


CRITICAL SECTION 
Purpose: Called by PRINT.COM to indicate the beginning and end of uninterruptible or nonreentrant code. 
Available on: All machines. Restrictions: Network software must be installed. 
Registers at call: Return Registers: n/a 
AH = 87h 
AL = start/end: 00h start 

Oh end 


Conflicts: None known, 
See Also: Functions 80h and 81h 


INTERRUPT 2Ah - Function 89h 


Unknown Function 


Purpose: unknown. 

Available on: All machines. Restrictions: Network software must be installed. 
Registers at call: Return Registers: unknown. 

AH = 89h 

AL = unknown.(ASSIGN uses 08h) 

unknown, 

Conflicts: None known. 


INTERRUPT 2Ah - Function C2h 


Unknown Function : 


Purpose: unknown. 
Available on: All machines. Restrictions: Network software must be installed. 
Registers at call: Return Registers: unknown. 
AH = C2h 
AL = subfunction 
O7h unknown, 
08h unknown. 
BX =0001h 
unknown, 
Details: This function is called by DOS 3.30 APPEND. 
Conflicts: None known. 


INTERRUPT 2Fh - Function 11h, Subfunctions 86h, 8Ah, and 8Fh 
LAN Manager ENHANCED SERVICES 


Purpose: Request enhanced functions such as encryption or named pipes. 
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Restrictions: LAN Manager DOS Enhanced version 
2.0 must be installed. 
Return Registers: unknown. 


Available on: Ali machines. 


Registers at call: 
AH = lih 
AL = function 
86h DosReadAsynchNmPipe 
8Ah (ENCRYPT.EXE) stream encryption 
8Fh DOSwriteAsynchNmPipe 
other registers vary according to function, but were 


not known at the time of writing. 
Details: LAN Manager enhanced mode adds features beyond the standard redirector file/printer services. 


See Also: Functions 41h, 42h, and 4Bh, INT 21h Function 5Fh Subfunctions 39h and 3Ah 
INTERRUPT 2Fh - Function 41h 


NETWORK POP-UP SERVICE 

Purpose: Communicate with the pop-up interface. 

Available on: All machines. Restrictions: LAN Manager DOS Enhanced version 
2.0 NETPOPUP.EXE module must be 
installed. 

Registers at call: Return Registers: unknown. 

AH = 41h 


other unknown. 
Details: LAN Manager enhanced mode adds features beyond the standard redirector file/printer services. 


Conflicts: None known. 
See Also: Function 11h Subfunction 8Ah, Functions 42h and 4Bh 


INTERRUPT 2Fh - Function 42h 


MESSENGER SERVICE 

Purpose: Communicate with the messenger module. 

Available on: All machines, Restrictions: LAN Manager DOS Enhanced version 
2.0 MSRV.EXE module must be 
installed. 

Registers at call: Return Registers: unknown. 

AH = 42h 


other unknown. 

Details: LAN Manager enhanced mode adds features beyond the standard redirector file/printer services. 
Conflicts: None known. 

See Also: Function 11h Subfunction 8Ah, Functions 41h and 4Bh 


INTERRUPT 2Fh - Function 4Bh 
NETWORK WORKSTATION REDIRECTOR 


Purpose: Communicate with the enhanced workstation redirector. 


Available on: All machines. 
Restrictions: LAN Manager DOS Enhanced version 


2.0 NETWKSTA.EXE module must be 
installed, 

Registers at call: Return Registers: unknown. 

AH = 4Bh 

other unknown, 

Details: LAN Manager enhanced mode adds features beyond the standard redirector file/printer services, 


Conflicts: DOS 5 task switcher (chapter 8). 
See Also: Function 11h Subfunction 8Ah, Functions 41h and 42h 
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INTERRUPT 2Fh - Function 80h, Subfunction 00h 


INSTALLATION CHECK 

Purpose: Determine whether EASY-NET is installed. 

Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AX = 8000h AL = 00h not installed 


FFh installed 
Details: EASY-NET is a shareware two-machine serial-port network by EasyNet Systems, Inc. 


INTERRUPT 2Fh - Function B8h, Subfunction 00h 


INSTALLATION CHECK 

Purpose: Determine whether network software is installed. 

Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AX = B800h AL = status 


00h not installed 
nonzero installed 
BX = installed component flags (test in this order!) 
bit6 server 
bit2 messenger 
bit7 receiver 
bit 3 redirector 
Conflicts: None known. 


INTERRUPT 2Fh - Function B&8h, Subfunction 03h 
GET NETWORK EVENT POST HANDLER 


Purpose: Determine which routine the network software invokes on network events. 


Available on: All machines. Restrictions: Network software must be installed. 

Registers at call: Return Registers: 

AX = B803h ES:BX -> event post handler (see Function B8h 
Subfunction 04h) 


Conflicts: None known. 
See Also: Function B8h Subfunction 04h, Function B9h Subfunction 03h (chapter 19) 


INTERRUPT 2Fh - Function B&8h, Subfunction 04h 
SET NETWORK EVENT POST HANDLER 


Purpose: Specify which routine the network software should invoke on network events. 


Available on: All machines. : Restrictions: Network software must be installed. 
Registers at call: Return Registers: unknown. 
AX = B804h 


ES:BX -> new event post handler 

Details: This call is used in conjunction with Function B8h Subfunction 03h to hook into the network event post 
routine. The specified handler is called on any network event. Two events are defined: message received and critical 
network error. 

Conflicts: None known. 

See Also: Function B8h Subfunction 03h, Function B9h Subfunction 04h (chapter 19) 


Post routine is called with: Returns with: 

AX = 0000h single block message AX = response code 
DS:SI -> ASCIZ originator name 0000h user post routine processed message 
DS:DI -> ASCIZ destination name 0001h PC LAN will process message, but message 
ES:BX -> text header (Table 27-16) window not displayed 


AX = 0001h start multiple message block FFFFh PC LAN will process message 


Miscellaneous Networking Calls 27-19 


CX = block group ID Note: Function 0101h always returns FFFFh, and 
DS:SI -> ASCIZ originator name Function 0103h may only return 0000h or FFFFh 
DS:DI -> ASCIZ destination name 
AX = 0002h multiple block text 
CX = block group ID 
ES:BX -> text header (Table 27-16) 
AX = 0003h end multiple block message 
CX = block group ID 
AX = 0004h message aborted due to error 
CX = block group ID 
AX =0101h server received badly formatted 
network request 
AX = 0102h unexpected network error 
ES:BX -> NCB (see INT 5Ch) 
AX = 0103h server received INT 24h error 
other registers as for INT 24h, except AH is in 
BH 


Table 27-16, Format of Text Header: 


Offset Size Description 
00h WORD length of text (maximum 512 bytes) 
02h NBYTEs _ text of message 


Details: All CRLF sequences in the message text are replaced by character 14h (control-T). 


INTERRUPT 2Fh - Function B8h, Subfunction 07h 
GET NetBIOS NAME NUMBER OF MACHINE NAME 


Purpose: Determine the NetBIOS number corresponding to the caller's machine's name. 


Available on: All machines. Restrictions: Network software must be installed. 
Registers at call: Return Registers: 
AX = B807h CH = NetBIOS name number of the machine name 


Conflicts: None known. 
See Also: INT 21h Function SEh Subfunction 00h (chapter 8) 


INTERRUPT 2Fh - Function B8h, Subfunction 08h 


Unknown Function 

Purpose: unknown. 

Available on: Ajl machines. Restrictions: Network software must be installed. 
Registers at call: Return Registers: unknown. 

AX = B808h 


other unknown. 
Conflicts: None known, 


INTERRUPT 2Fh - Function FFh, Subfunction 00h 


INSTALLATION CHECK 

Purpose: Determine whether the Topware Network Operating System is installed. 

Available on: All machines. Restrictions: none. 

Registers at call: Return Registers: 

AX = FFOOh AL = 00h not installed, OK to install 


= 01h not installed, not OK to install 
= FFh installed 
Conflicts: None known. 
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INTERRUPT 2Fh - Function FFh, Subfunction 01h 


GET VERSION 

Purpose: Determine which version of the Topware Network Operating System is installed. 

Available on: All machines. Restrictions: Topware Network Operating System 
must be installed, 

Registers at call: Return Registers: 

AX = FFOIh AX = version 

Conflicts: None known. 

INTERRUPT 50h 

TIL Xpert AIM (X.25) 

Purpose: Communicate with the TIL X.25 networking software. 

Available on: All machines. Restrictions: TIL Xpert AIM must be installed. 

Registers at call: Return Registers: sknown. 

AH = function 

Conflicts: None known. 

INTERRUPT 5Ah 

Cluster Adapter BIOS entry address 

Purpose: Communicate with the Cluster Adapter BIOS. 

Available on: All machines. Restrictions: Cluster Adapter BIOS must be installed, 

Registers at call: unknown. Return Registers: unknown. 

Conflicts: DESQview 2.26+ IRQ10, DoubleDOS IRQ2 (Chapter 2). 

INTERRUPT 5Bh 


AT&T Starlan Extended NetBIOS (variable length names) 


Purpose: Perform NetBIOS commands using variable-length names rather than the standard fixed-length names. 

Available on: All machines. Restrictions; AT&T Starlan Extended NetBIOS 
(supporting variable-length names) 
must be installed. 

Registers at call; Return Registers: 

ES:BX -> Network Control Block (Table 27-17) AL = status (see INT 5Ch) 

Conflicts: Microsoft Network Transport Layer Interface; Cluster Adapter, IRQ3 relocated by DoubleDOS and 

IRQH relocated by DESQview 2.26+ (chapter 2). : 

See Also: INT 5Ch i 


Table 27-17. Format of Network Control Block 


Offset Size Description 

00h BYTE ncb_command (see below) 
Olh BYTE neb_retcode 

02h BYTE neb_Isn 

03h BYTE neb_num 

04h DWORD  ->ncb_buffer 

O8h WORD neb_length 

OAh 16BYTEs neb_caliname 

1Ah 16BYTEs ncb_name 

2Ah BYTE ncb_rto 

2Bh BYTE neb_sto 

2Ch DWORD _ ->ncb_post /* int (far *neb_post)(); */ 
30h BYTE neb_lana_num 

3lh BYTE neb_cmd_eplt 


32h DWORD — ->ncb_vname 
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Table 27-17, Format of Network Control Block (continued) 


Offset Size Description 
36h BYTE neb_ynamelen 
37h OBYTEs ncb_reserve 


Details: Fields 00h-31h are the same as for a standard NetBIOS NCB (see INT 5Ch), Values for the ncb_command 


field are the same as for INT 5Ch, except: 
70h send net Break 


INTERRUPT 5Bh 


Microsoft Network Transport Layer Interface 
Purpose: Communicate with the Network Transport Layer module. 


Available on: All machines. Restrictions: Microsoft Network Transport Layer 
must be installed. 
Registers at call: unknown. Return Registers: unknown. 


Conflicts: Cluster Adapter; AT&T Starlan Extended NetB1OS; IRQ3 relocated by DoubleDOS and IRQI] relocated 
by DESQview 2.26+ (chapter 2) 


INTERRUPT 5Bh 

Used by cluster adapter 

Purpose: unknown, 

Available on: All machines. Restrictions: Cluster adapter must be installed. 
Conflicts: AT&T Starlan Extended NetBIOS; Microsoft Network Transport Layer Interface; IRQ3 relocated by 
DoubleDOS and IRQ] 1 relocated by DESQview 2.26+ (chapter 2). 


INTERRUPT 5Ch 

INSTALLATION CHECK 

Purpose: Determine whether the $25 LAN by Information Modes is installed. 
Available on: All machines, Restrictions: none. 


Details: Current versions only check whether the vector is 0000h:0000h or not. Future versions are supposed to have 
the signature "NET" in the three bytes preceding the INT 5C handler. 

Conflicts: IRQ4 relocated by DoubleDOS and IRQI2 relocated by DESQview 2.26+ (chapter 2); $25 LAN, 
ATALK.SYS, IBM 802.2 interface (LLC), NetBIOS interface, and TOPS interface (chapter 27). 


INTERRUPT 5Ch - Function 04h 
CHECK IF CONNECTION ALIVE 


Purpose: Determine whether the connection to the remote machine has been established and is valid. 


Available on: All machines. Restrictions: $25 LAN must be installed, 
Registers at call: Return Registers: 
AH = 04h ZF set if link alive 


AL = COM port (0 = default) 
CX = wait count in character times (should be at 

least L00) 
Details: The $25 LAN is a network which connects two machines via their serial ports; up to three machines may be 
connected by dedicating both ports on one machine to the network. 
Conflicts: IRQ4 relocated by DoubleDOS and IRQI2 relocated by DESQview 2.26+ (chapter 2); $25 LAN, 
ATALK.SYS, IBM 802.2 interface (LLC), NetBIOS interface, and TOPS interface (chapter 27). 


INTERRUPT 5Ch 
ATALK.SYS - AppleTalk INTERFACE 


Purpose: Communicate with the AppleTalk module. 
Available on: All machines. Restrictions: ATALK.SYS must be installed. 
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Registers at call: 
DX:BX -> control block (Table 27-18) 


Return Registers: n/a 


Details: This driver can use any interrupt from 5Ch to 70h. The signature 'AppleTalk' appears 16 bytes prior to the 
interrupt handler; this serves as the installation check. 

Conflicts: IRQ4 relocated by DoubleDOS and IRQI2 relocated by DESQview 2.26+ (chapter 2); $25 LAN, 
ATALK.SYS, IBM 802.2 interface (LLC), NetBIOS interface, and TOPS interface (chapter 27). 


Table 27-18. Format of AppleTalk Contro. 

Offset Size Description 

00h WORD command code 
Olh "AT_INIT" 
02h "AT_KILL" 
03h "AT_GET! 


1 Block: 


initialize the driver 


ETINFO" get current network info incl init status 


04h "AT_GETCLOCKTICKS" 
05h "AT_STARTTIMER" 

06h "AT_RESETTIMER" 

07h "AT_CANCELTIMER" 


10h "LAP_INS1 


TALL" 


11h "LAP_REMOVE" 


12h "LAP_WR. 


TE” 


13h "LAP_READ" 

14h "LAP_CANCEL" 

20h "DDP_OPENSOCKET" 
21h "DDP_CLOSESOCKET" 





22h "DDP_WR 


“PRN 


23h "DDP_READ" 

24h "DDP_CANCEL" 

30h "NBP_REGISTER"” 
31h "NBP_REMOVE" 
32h "NBP_LOOKUP" 
33h "NBP_CONFIRM" 
34h "NBP_CANCEL" 

35h "“ZIP_GETZONELIST" 
36h "ZIP_GETMYZONE" 
37h "ZIP_TAKEDOWN" 
38h "ZIP_BRINGUP" 


t 


i) 





1 


40h "ATP_OPE 


NSOCKET" 


41h "ATP_CLOSESOCKET" 

42h "ATP_SENDREQUEST” 

43h "ATP_GETREQUEST" 

44h "ATP_SENDRESPONSE" 
45h "ATP_ADDRESPONSE" 

46h "ATP_CANCELTRANS" 
47h "ATP_CANCELRESPONSE" 
48h "“ATP_CANCELREQUEST" 
50h “ASP_GETPARMS" 


51h “ASP_CLO; 


SESESSION" 


52h "ASP_CANCEL" 


53h "ASP_INIT’ 


54h "ASP_KILL" 

55h "ASP_GETSESSION" 
56h "ASP_GETREQUEST" 
57h "ASP_CMDREPLY" 

58h "ASP_WRTCONTINUE" 
59h “ASP_WRTREPLY" 
5SAh "ASP_CLOSEREPLY" 
5Bh “ASP_NEWSTATUS" 
5Ch "ASP_ATTENTION" 
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Table 27-18. Format of AppleTalk control block (continued) 


Offset Size Description 


02h 


04h 
O8h 
OAh 


5Dh "ASP_GETSTATUS" 
5Eh "ASP_OPENSESSION" 
5Fh "ASP_COMMAND" 
60h "“ASP_WRITE" 
61h “ASP_GETATTENTION"” 
70h “PAP_OPEN" 
71h "PAP_CLOSE" 
72h "PAP_READ" 
73h "PAP_WRITE" 
74h "PAP_STATUS" 
75h "PAP_REGNAME" 
76h "PAP_LREMNAME” 
77h "PAP_INIT" 
78h "PAP_NEWSTATUS" 
79h “PAP_GETNEXTJOB" 
7A "PAP_KILL” 
7Bh "PAP_CANCEL” OR with the following flags: 
8000h start command then return 
4000h wait for interrupt service to complete 
WORD returned status: 
0000h success (already initialized if func 01h) 
DWORD pointer to completion function 
WORD network number 
BYTE node ID 





~--if general function (01h,03h) 


OBh 
0Ch 
OEh 





OBh 
0Ch 
OEh 
12h 
I4h 
{5h 
toh 


---if AppleTalk 





BYTE “inf_abridge" 
WORD “inf_config" 
DWORD pointer to buffer 
WORD buffer size 


~if DDP function (20h-24h) 
h 


BYTE “ddp_addr_socket" 
BYTE 
BYTE 
DWORD 
WORD 
BYTE "ddp_chksum" 





---if Name Binding Protocol (30h-34h) 
BYTE 


"nbp_addr_socket" 
WORD “nbp,toget" 
DWORD _ pointer to buffer (Table 27-19) 
WORD buffer size 
BYTE “nbp_interval" 
BYTE “nbp_retry” 
DWORD — "nbp_entptr" 


Transaction Protocol (42h) 
BYTE “atp_addr_socket" 
WORD “atp_socket" 
DWORD _ pointer to buffer 
WORD buffer size 
BYTE “atp_interval" 
BYTE "atp_retry” 
BYTE ATP flags 

bit 5: exactly one transaction 
BYTE “atp_seqbit” 
BYTE transaction ID 


27-23 
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Table 27-18. Format of AppleTalk Control Block (continued) 


Offset Size Description 

19h 4BYTEs ATP user bytes 

1Dh- BYTE number of BDS buffers 

1Eh BYTE number of BDS responses 

1Fh DWORD pointer to BDS buffers (Table 27-20) 


Table 27-19. Format of Name Binding Protocol Name-to-Address Binding Entries for NBP_LOOKUP: 


Offset Size Description 

00h WORD “tup_address_network” 
02h BYTE “tup_address_notid” 
03h BYTE "tup_address_socket" 
04h BYTE “tup_enum" 

05h 99BYTEs name 


Table 27-20. Format of BDS Entries: 


Offset Size Description 

00h DWORD pointer to buffer 
04h WORD size of buffer 
06h WORD BDS data size 
08h 4BYTEs "“bds_userbytes" 
INTERRUPT 5Ch 


IBM 802.2 INTERFACE (LLC) 


Purpose: Communicate with the LLC module. 

Available on: Ali machines. Restrictions: IBM 802.2 Interface must be installed. 
Registers at call: Return Registers: n/a 

ES:BX -> CCB (Table 27-21) 

Conflicts: IRQ4 relocated by DoubleDOS and IRQ12 relocated by DESQview (chapter 2); $25 LAN, ATALK.SYS, 
IBM 802.2 interface (LLC), NetBIOS interface, and TOPS interface (chapter 27). 


Table 27-21. Format of CCB: 


Offset Size Description 

00h BYTE adapter 

Oth BYTE command code 

02h BYTE return code 

03h BYTE work 

04h DWORD pointer to unknown code or data 

08h DWORD pointer to completion function 

0Ch DWORD pointer to parameters 

INTERRUPT 5Ch 

NetBIOS INTERFACE 

Purpose: Perform NetBIOS network commands. 

Available on: All machines. Restrictions: NetBIOS must be installed. 
Registers at call: Return Registers: 
ES:BX -> network control block AL = status (Table 27-22) 


(NCB) (Table 27-23) 

Details: The Sytek PCnet card uses DMA channel 3. 

Conflicts: $25 LAN, ATALK.SYS, IBM 802.2 interface, TOPS interface, and NetBIOS; IRQ4 relocated by 
DoubleDOS and IRQ12 relocated by DESQview (chapter 2). 

See Also: INT SBh 


Table 27-22. 


Value 
00h 

Olh 
03h 
05h 
06 
07h 
08h 
09) 
OAh 
OBh 
ODh 
OEh 
OFh 
lih 
12h 
13h 
14h 
15h 
16h 


Table 27-23. 


Offset 
00h 
01 
02. 
03. 
04h 
08h 
OAh 
1Ah 
2Ah 
2Bh 
2Ch 
30h 








3th 
32h 


Table 27-24, 


Value 
10h 


1th 
12h 


14h 
15h 
16h 
(7h 
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Values of NetBIOS Status Codes: 

Meaning Value Meaning 

successful 17h bad delete 

bad buffer size 18h abnormal end 

invalid NETBIOS command 19h name error, multiple identical names in use 
timeout [Ah bad packet 

receive buffer too small 21h network card busy 

No-ACK command failed 22h too many commands queued 

bad session number 23h bad LAN card number 

LAN card out of memory 24h command finished while cancelling 
session closed 26h command can't be cancelled 

command has been cancelled 30h name defined by another process (OS/2) 
name already exists 34] NetBIOS environment not defined, must 
local name table full issue reset (OS/2) 

name still in use, can't delete 35) required operating system resources 
local session table full exhausted (OS/2) 

remote PC not listening 36h maximum applications exceeded (OS/2) 
bad NCB_NUM field 37h no SAPs available for NetBIOS (OS/2) 
no answer to CALL or no such remote 38h requested resources not available (OS/2) 
name not in local name table FFh NetBIOS busy (command pending) 


duplicate name 


Format of Network Control Block: 


Size Description 


BYTE command code (Table 27-24) 


BYTE return code 


BYTE local session number (LSN) 





BYTE “ncb_num" datagram table entry from ADD NAME 


DWORD -> I/O buffer 
WORD length of data in buffer 
16BYTEs remote system to call 


16 BYTEs network name of local machine 
BYTE receive timeout in 1/2 seconds 
BYTE send timeout in 1/2 seconds 
DWORD _ -> FAR post handler /* int (far *ncb_post)(); */ 
BYTE network adapter number on which to execute command 
00h-03h IBM NetBIOS specs 
FOh-FFh Eicon NABios interface 
BYTE command completion code (see returned status above) 
14 BYTEs reserved for network card 
Values for command code field in NCB (or with 80h for non-waiting call): 
Meaning Value Meaning 
start session with NCB_NAME name 20h send unACKed message (datagram) 
(call) 2th receive datagram 
listen for call 22h send broadcast datagram 
end session with NCB_NAME name 23h receive broadcast datagram 
(hangup) 30h add name to name table (Table 27-25) 


send data via NCB_LSN 


3th delete name from name table 


receive data from a session 32h reset adapter card and tables 
receive data from any session 33h get adapter status (Table 27-26} 
send multiple data buffers 34h status of all sessions for name (Table 27- 


27) 


27-26 Miscellaneous Networking Calls 


Table 27-24, Values for command code field in NCB (continued) 


Value Meaning Value 
35 cancel 7th 
36) add group name to name table 72h 
70h unlink from IBM remote program (no 78h 
FOh function) 79h 


Table 27-25, Format of Structure "name": 


Offset Size Description 

00h 16BYTEs “nm_name" symbolic name 

10h BYTE “nam_num” number associated with name 
llh BYTE nm_status 


Table 27-26. Format of Structure “astatus": 











Offset Size Description 
00h 6BYTEs  as_id 

06) BYTE as_jumpers 
O7h BYTE as_post 
08h BYTE as_major 
09h BYTE as_minor 
OAh WORD as_interval 
0Ch WORD as_crcerr 
OEh WORD as_algerr 
10h WORD as_colerr 
12h WORD as_abterr 
14h DWORD _ as_tcount 
18h DWORD _ as_rcount 
tel WORD as_retran 
{Eh WORD as_xresrc 
20h 8BYTEs  as_res0 
28h WORD as_nebfree 
2Ah WORD as_ncbmax 
2Ch WORD as_ncbx 
2Eh 4BYTEs  as_res| 
32h WORD as_sespend 
34h WORD as_msp 
36h WORD as_sesmax 
38h WORD as_bufsize 
3Ah WORD as_names 
3Ch 16 name structures as_name 


Table 27-27. Format of Structure “sstatus": 


Offset Size Description 

00h BYTE number of sessions being reported 

Olh BYTE number of sessions with this name 

02h BYTE number of outstanding receive datagrams 
03h BYTE number of outstanding ReceiveAnys 


04h var session structures (Table 27-28) 


Meaning 

send data without ACK 

send multiple buffers without ACK 
find name 

token-ring protocol trace 
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Table 27-28. Format of Strueture "session": 


Offset Size Description 
00h BYTE local session number 
Oth BYTE state: 
Oth listen pending 


02h call pending 
03h session established 


04h hangup pending 
05h hangup done 
06h session aborted 
02h 16 BYTEs local name 
12h 16 BYTEs remote name 
22h BYTE number of outstanding receives 
23h BYTE number of outstanding sends/chainsends 
INTERRUPT 5Ch 
TOPS INTERFACE 
Purpose: Communicate with the TOPS network program, 
Available on: All machines. Restrictions: TOPS software must be installed. 
Registers at call: Return Registers: n/a 


ES:BX -> Network Control Block (Table 27-23) 

Detai he TOPS card uses DMA channels | or 3, or non-DMA operation. 

Conflicts: IRQ4 relocated by DoubleDOS and IRQI2 relocated by DESQview 2.26+ (chapter 2); $25 LAN, 
ATALK.SYS, IBM 802.2 interface (LLC), NetBIOS interface, and TOPS interface (chapter 27). 


INTERRUPT 60h 
FTP Packet Driver - PC/TCP Packet Driver Specification 


Purpose: Provide portable access to a wide variety of network hardware. 

Available on: All machines, Restrictions; FTP Packet Driver must be installed. 
Details: The handler for the interrupt will start with a 3-byte jump instruction, followed by the ASCIZ string "PKT 
DRVR". To find the interrupt being used by the driver, an application should scan through interrupt vectors 60h to 
80h until it finds one with the "PKT DRVR" string. 

Conflicts: See chapter 1. 


INTERRUPT 60h - Function 01h, Subfunction FFh 





GET DRIVER INFORMATION 

Purpose: Determine the version and type of the packet driver which is installed. 

Available on: All machines. Restrictions: FTP Packet Driver must be installed. 
Registers at call: Return Registers: 

AX = O1FFh CF set on error 

BX = handle returned by function 02h DH = error code (Table 27-29) 


CF clear if successful 
BX = version 
CH = network interface class (see below) 
DX = interface type (Table 27-30) 
CL = number 
DS:SI -> name 
AL = driver functions supported 
Olh basic 
02h basic and extended 
05h basic and high-performance 
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06h basic, high-performance, and extended 
FFh not installed 


Details: The handle in BX is optional for drivers written to version 1.07 or later of the packet driver specification. 


Conflicts: See chapter |. 


Table 27-29. Values for Error Code: 


Oth invalid handle number 

02h no interfaces of the specified class 
found 

03h no interfaces of the specified type 
found 

04h no interfaces of the specified number 
found 

05h bad packet type 

06h interface does not support multicast 
messages 


Table 27-30. Values for Network Interface classes/types: 





Class Olh — Ethernet/IEEE 802.3 

Olh 3COM 3C500/3C501 

02h 3COM 3C505 

03h MICOM-Interlan NI5010 
04h BICC Data Networks 4110 
05h BICC Data Networks 4117 
06h MICOM-Interlan NP600 
08h Ungermann-Bass PC-NIC 
09h Univation NC-516 

OAh TRW PC-2000 

OBh MICOM-Interlan NI5210 
0Ch 3COM 3C503 

ODh 3COM 3C523 

OEh Western Digital WD8003 
OFh Spider Systems $4 

10h Torus Frame Level 

1th 10Net Communications 
12h Gateway PC-bus 

13h Gateway AT-bus 

14h Gateway MCA-bus 

15h IMC PCnic 

16h IMC PCnic II 

17h IMC PCnic 8-bit 

18h Tigan Communications 
19h Micromatic Research 

1Ah Clarkson "Multiplexor" 
1Bh D-Link 8-bit 

1Ch D-Link 16-bit 

1Dh D-Link PS/2 

1Eh Research Machines 8 

IFh Research Machines 16 
20h Research Machines MCA 
2th Radix Microsystems EXM1 16-bit 
22h Interlan Ni9210 

23h Interlan Ni6510 

24h Vestra LANMASTER 16-bit 


07h this packet driver cannot terminate 
08h invalid receiver mode 
09h insufficient space 





0A! type accessed but never released 

OBh bad command 

0Ch packet could not be sent 

ODh hardware address could not be changed 

OEh hardware address has a bad length or 
format 

OFh could not reset interface 

25h Vestra LANMASTER 8-bit 

26h Allied Telesis PC/XT/AT 

27h Allied Telesis NEC PC-98 

28) Allied Telesis Fujitsu FMR 

29h Ungermann-Bass NIC/PS2 

2Ah Tiara LANCard/E AT 

2Bh Tiara LANCard/E MC 

2Ch Tiara LANCard/E TP 

2Dh Spider Communications SpiderComm 8 

2Eh Spider Communications SpiderComm 16 

2Fh AT&T Starlan NAU 

30h AT&T Starlan-10 NAU 

3th AT&T Ethernet NAU 

32h Intel smart card 

Class 02h ProNET-10 

Olh Proteon p1300 

02h Proteon p1800 


Class 03h IEEE 802,5/ProNet-4 


Oth IBM Token-Ring Adapter 
02h Proteon p1340 

03h Proteon p1344 

04h Gateway PC-bus 

05h Gateway AT-bus 

06h Gateway MCA-bus 


Class 04h Omninet 

Class 0Sh Appletalk 

Class 06h Serial Line 

Oh Clarkson 8250-SLIP 

02h Clarkson “Multiplexor" 

Class 07h StarLAN (subsumed by Ethernet class) 

Class 08h ARCnet 

Olh Datapoint RIM 

Class 09h AX.25 

Class OAh KISS 

Class OBh IEEE 802,3 with 802.2 headers 
types same as for class Oth 
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Table 27-30. Values for Network Interface Classes!Types (continued) 


Class OCh FDDI with 802.2 headers Class OEh N.T. LANSTAR (encapsulating DIX 
Class ODh Internet X.25 Ethernet) 

Oth Western Digital Oth NT LANSTAR/8 

02h Frontier Technology 02h NT LANSTAR/MC 


Note: The class and type numbers are cleared through FTP Software. 


INTERRUPT 60h - Function 02h 
ACCESS TYPE 


Purpose: Prepare to use the specified interface type; informs the packet driver that it should perform whatever 
initialization is necessary. 


Available on: All machines. Restrictions: FTP Packet Driver must be installed. 
Registers at call: Return Registers: 

AH = 02h CF set on error 

AL = interface class DH =error code (see Function OLh 

BX = interface type Subfunction FFh) 

DL = interface number CF clear if successful 

DS:SI -> type AX = handle 


CX = length of type 
ES:DI -> receiver 
Conflicts: See chapter |. 
See Also: Function 03h 


Receiver is called with: 
AX = subfunction: 
00h application to return pointer to buffer in ES:DI 
returned BS:DI = 0000h:0000h means throw away packet 
Olh copy completed 
DS:SI -> buffer 
BX = handle 
CX = buffer length 
when a packet is received 


INTERRUPT 60h - Function 03h 


RELEASE TYPE 

Purpose: Indicate that the specified interface will no longer be needed; the packet driver may perform any necessary 
cleanup. 

Available on: All machines. Restrictions: FTP Packet Driver must be installed. 
Registers at call: Return Registers: 

AH = 03h CF set on error 

BX = handle DH = error code (see Function 01h 


Subfunction FFh) 
CF clear if successful 
Conflicts: See chapter I. 
See Also: Function 02h 


INTERRUPT 60h - Function 04h 


SEND PACKET 


Purpose: Transmit data over the network. 
Available on: All machines. Restrictions: FTP Packet Driver must be installed. 
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Registers at call: Return Registers: 

AH = 04h CF set on error 

DS:SI -> buffer DH = error code (see Function 01h 
CX = length Subfunction FFh) 


CF clear if successful 
Details: The buffer may be modified immediately upon return from this call. 
Conflicts: See chapter 1. 
See Also: Function OBh 


INTERRUPT 60h - Function 05h 
TERMINATE DRIVER FOR HANDLE 


Purpose: Stop providing network services for the specified connection. 


Available on: All machines. Restrictions: FTP Packet Driver must be installed. 

Registers at call: Return Registers: 

AH = 05h CF set on error 

BX = handle DH = error code (see Function 01h 
Subfunction FFh) 


CF clear if successful 
Conflicts: See chapter t. 


INTERRUPT 60h - Function 06h 


GET ADDRESS 

Purpose: Determine the caller's network address. 

Available on: All machines. Restrictions: FTP Packet Driver must be installed. 
Registers at call: Return Registers: 

AH = 06h CF set on error 

BX = handle DH = error code (see Function 01h 

ES:DI -> buffer Subfunction FFh) 

CX = length CF clear if successful 


CX = length of returned address i 
Details: This function copies the local net address associated with the handle into the buffer. / 
Conflicts: See chapter 1. i 


INTERRUPT 60h - Function 07h 


RESET INTERFACE 

Purpose: Place the network adapter hardware into a known initial state. 

Available on: All machines. Restrictions: FTP Packet Driver must be installed. 
Registers at call: Return Registers: 

AH = 07h CF set on error 

BX = handle DH = error code (see Function 01h 


Subfunction FFh) 
CF clear if successful 
Conflicts: See chapter 1. 


INTERRUPT 60h - Function 0Ah 
GET PARAMETERS 


Purpose: Determine the sizes and addresses of various data structures used by the packet driver, as well as the 

version of the packet driver specification supported by the driver. 

Available on: All machines. Restrictions: FTP Packet Driver supporting the 
version 1.09 high-performance function 
set must be installed. 


i 
i 
\ 
| 
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Registers at call: Return Registers: 
AH=0Ah CF set on error 
DH = error code (OBh) (see Function 01h 
Subfunction FFh) 
CF clear if successful 
ES:DI -> parameter table (Table 27-31) 
Conflicts: See chapter |. 


Table 27-31. Format of Packet Driver Parameter Table: 


Offset Size Description 

00h BYTE major revision of packet driver spec to which the driver conforms 
Olh BYTE minor revision of packet driver spec 

02h BYTE length of this structure in bytes 

03h BYTE length of a MAC-layer address 

04h WORD maximum transfer unit, including MAC headers 

06h WORD buffer size for multicast address 

O8h WORD number of receive buffers (one less than back-to-back MTU receives) 
OAh WORD number of transmit buffers 

0Ch WORD interrupt number to hook for post-EOI processing, OOh=none 


INTERRUPT 60h - Function 0Bh 

ASYNCHRONOUS SEND PACKET 

Purpose: Transmit a block of data without waiting for the transmission to complete. 

Available on: All machines. Restrictions: FTP Packet Driver supporting the 
version 1.09 high-performance function 
set must be installed. 


Registers at call: Return Registers: 
AH =0Bh CF set on error 
DS:SI -> buffer DH = error code (OBh,OCh) (see Function 01h 
CX = length of buffer Subfunction FFh) 
ES:DI -> FAR function to call when buffer becomes CF clear if successful 
available 


Details: Unlike function 04h, the buffer for this call is not available for modification as soon as the call returns; the 
buffer may be queued by the driver and not processed until later. 

Conflicts: See chapter 1. 

See Also: Function 04h 


Completion function called with: 
AX = result 
00h copy OK 
nonzero error 
ES:DI -> buffer passed to Function OBh call 


INTERRUPT 60h - Function 0Ch 


GET STATION ADDRESS 

Purpose: Determine the network address of the caller's machine. 

Available on: All machines. Restrictions: 3com or Banyan VINES must be 
installed. 

Registers at call: Return Registers: 

AH =0Ch AL = status 


00h successful 
ES:SI -> 6-byte station address 
02h semaphore service is unavailable 
Conflicts: See chapter I. 





| 
| 
i 
\ 
\ 
\ 
\ 


27-32 Miscellaneous Networking Calls 


INTERRUPT 60h - Function 11h 


LOCK AND WAIT 
Purpose: Request exclusive access to the specified resource, waiting until it becomes available or a timeout elapses. 
Available on: All machines. Restrictions: 3com, 10-NET or Banyan VINES must 
be installed. 
Registers at call: Return Registers: 
AH= 11h AL = status 
AL = drive number or 0 00h successful 
DX = number of seconds to wait Oth timeout 
ES:SI = Ethernet address or 0 02h server not responding 
DS:BX -> 31-byte ASCIZ semaphore name 03h invalid semaphore name 
04h semaphore list is full 
05h invalid drive ID 


06h invalid Ethernet address 

07h not logged in 

O8h write to network failed 

09h semaphore already logged for this CPU 
Conflicts: See Chapter 1. 
See Also: Functions [2h and 13h 


INTERRUPT 60h - Function 12h 
LOCK 


Purpose: Attempt to gain exclusive access to a resource. 


Available on: All machines. Restrictions: 3com, 10-NET or Banyan VINES must 
be installed. 

Registers at call: Return Registers: 

AH = 12h AL = status (see also Function 11h) 

AL = drive number or 00h Olh semaphore currently locked by another PC 


ES:SI = Ethernet address or 0000h:0000h 

DS:BX -> 31-byte ASCIZ semaphore name 

Details: Unlike Function I th, this function returns immediately. 
Conflicts: See Chapter 1. 

See Also: Functions 11h and 13h 


INTERRUPT 60h - Function 13h 
UNLOCK 


Purpose: Indicate that the specified resource is now available to others, 


Available on: All machines. Restrictions: 3com, 10-NET or Banyan VINES must 
be installed. 

Registers at call: Return Registers: 

AH = 13h AL = status (see also Function 11h) 

AL = drive number or 00h 01h semaphore not locked 


ES:SI = Ethernet address or 0000h:0000h 
DS:BX +> 31-byte ASCIZ semaphore name 
Conflicts: See Chapter 1. 

See Also: Functions 11h and 12h 


INTERRUPT 60h - Function 14h 


SET RECEIVE MODE 
Purpose: Specify which types of packets will be received from the network. 
Available on: All machines, Restrictions: FTP Packet Driver supporting the 


extended function set must be installed. 


Registers at call: 

AH = [4h 

BX = handle 

CX = mode 
Oth turn off receiver 
02h receive only packets sent to this interface 
03h mode 2 plus broadcast packets 
04h mode 3 plus limited multicast packets 
05h mode 3 plus all multicast packets 
06h all packets 

Conflicts: See chapter 1. 

See Also: Function 15h 


INTERRUPT 60h - Function 15h 
GET RECEIVE MODE 
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Return Registers: 
CF set on error 
DH = error code (01h,08h) (see Function 01h 
Subfunction FFh) 
CE clear if successful 


Purpose: Determine which types of network packets are currently accepted by the packet driver, 


Available on: All machines. 


Registers at call: 
AH = [5h 
BX = handle 


Conflicts: See chapter 1, 
See Also: Function 14h 


INTERRUPT 60h - Function 16h 
SET MULTICAST LIST 


Purpose: Specify the destinations of a multicast. 
Available on: All machines. 


Registers at call: 

AH = 16h 

ES:DI -> multicast list 

CX = length of list in bytes 


Conflicts: See chapter |, 
See Also: Function 17h 


INTERRUPT 60h - Function 17h 
GET MULTICAST LIST 


Purpose: Determine the destinations of a multicast. 
Available on: All machines. 


Registers at call: 
AH = 17h 


Conflicts: See chapter |. 


Restrictions: FTP Packet Driver supporting the 
extended function set must be installed. 

Return Registers: 
CF set on error 

DH = error code (01h) (see Function Olh 
Subfunction FFh) 
CF clear if successful 

AX = mode 


Restrictions: FTP Packet Driver supporting the 
extended function set must be installed. 
Return Registers: 
CF set on error 
DH = error code (06h,09h,0Eh) (see Function 01h 
Subfunction FFh) 
CF clear if successful 


Restrictions: FTP Packet Driver supporting the 
extended function set must be installed. 

Return Registers: 
CF set on error 

DH = error code (06h,09h) (see Function 01h 
Subfunction FFh) 
CF clear if successful 

ES:DI -> multicast addresses (do not modify) 

CX = bytes of multicast addresses currently in use 
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See Also: Function 16h 


INTERRUPT 60h - Function 18h 


GET STATISTICS 

Purpose: Determine how much data has been transferred over the network and how many errors occurred. 

Available on: All machines. Restrictions: FTP Packet Driver supporting the 

extended function set must be installed. 

Registers at call: Return Registers: 

AH = 18h CF set on error 

BX = handle DH = error code (01h) (see Function 01h 
Subfunction FFh) 


CF clear if successful 
DS:SI -> statistics (Table 27-32) 
Conflicts: See chapter |. 


Table 27-32. Format of Statistics: 


Offset Size Description 

00h DWORD packets in 

04h DWORD packets out 

08h DWORD bytes in 

0Ch DWORD bytes out 

10h DWORD - errors in 

14h DWORD - errors out 

18h DWORD packets dropped 
INTERRUPT 60h - Function 19h 

SET NETWORK ADDRESS 
Purpose: Specify the network address to be used by the packet driver, 
Available on: All machines. Restrictions: FIP Packet Driver supporting the 
extended function set must be installed. 
Registers at call: Return Registers: 
AH = 19h CF set on error 
ES:DI -> address DH = error code (ODh,OEh) (see Function 01h 
CX = length of address Subfunction FFh) 
CF clear if successful 
CX = length 


Conflicts: See chapter 1. 
INTERRUPT 61h 
FTP Software PC/TCP - TCP/AP TSR System Cail interface 


Purpose: Communicate with the resident module providing Internet TCP/IP (Transmission Control Protocol/Internet 
Protocol) functionality. 


Available on: All machines. Restrictions: FTP TCP/IP TSR must be installed. 
Registers at call: Return Registers: 
AH = system call number AL = basic error 


AH = suberror number 
Conflicts: See chapter 1. 


INTERRUPT 65h 

POST PROCESSING INTERRUPT 

Purpose: Called by the packet driver after processing is complete. 

Available on: All machines. Restrictions: FTP Software NDIS-Packet Driver must 
be installed. 
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Registers at call: unknown. Return Registers: unknown. | 
Conflicts: See chapter 1. | 


INTERRUPT 67h - Function 00h 


LOCK SEMAPHORE AND WAIT 

Purpose: Request exclusive access to the specified resource, waiting until it becomes available. 

Available on: Ali machines. Restrictions: PC-Net or Alloy networking software 
must be installed. 

Registers at call: Return Registers: 

AH = 00h AL = status 

DS:DX -> ASCIZ semaphore name (max 64 bytes) 00h successful 


Oh invalid function 
02h semaphore already locked 
03h unable to lock semaphore 
04h semaphore space exhausted 
AH = semaphore owner if status=02h 
Conflicts: None known. 
See Also: Functions 01h and 02h, INT 7Fh Function 00h (chapter {8) 


INTERRUPT 67h - Function 01h 


LOCK SEMAPHORE / 
Purpose: Attempt to gain exclusive access to the specified resource. | 
Available on: All machines. Restrictions: PC-Net or Alloy networking software i 
must be installed. | 
Registers at call: Return Registers: \ 
AH=0lh AL = status (see Function 00h) t 
DS:DX -> ASCIZ semaphore name (max 64 bytes) AH = semaphore owner if status=02h 
Conflicts: None known, 
See Also: Functions 00h and 02h, INT 7Fh Function 01h (chapter 18) 
INTERRUPT 67h - Function 02h 
UNLOCK SEMAPHORE 
Purpose: Indicate that the specified resource is now available for use by others. 
Available on: All machines. Restrictions: PC-Net or Alloy networking software 
must be installed. 
Registers at call: Return Registers: 
AH = 02h AL = status (see Function 00h) 
DS:DX -> ASCIZ semaphore name (max 64 bytes) AH = semaphore owner if status=02h 
Conflicts: None known. 
See Also: Functions 00h and Olh, INT 7Fh Function 02h (chapter 18) 
INTERRUPT 7Ah 
Unknown Function 
Purpose: unknown. 
Available on: All machines. Restrictions: Topware Network Operating System 
must be installed. 
Registers at call: Return Registers: unknown. 


AL = unknown. 

others, if any, unknown, 

Conflicts: Novell NetWare Low-level API (chapter 20), IBM 3270 Workstation Program API (chapter 26), 
AutoCAD Device Interface (chapter 36), 
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INTERRUPT 7Fh - Function 43h, Subfunction 54h 
CONVERGENT TECHNOLOGIES ClusterShare CTOS ACCESS VECTOR 


Purpose: Communicate with the ClusterShare software. 


Available on: All machines. Restrictions: Convergent Technologies ClusterShare 
software must be installed. 
Registers at call: Return Registers: 
CX = 4354h (‘CT’) AX = status 
AL = request ID 0000h successful 
Olh “Request"/"RequestDirect" 
ES:BX -> pRq 
DX ignored 
04h “Wait" 


ES:BX -> ppMsgRet 
DX = exchange 

05h "AllocExch" 
ES:BX -> pExchRet 

06h “DeAllocExch" 
DX = exchange 

07h "Check" 
ES:BX -> ppMsgRet 
DX = exchange 

Conflicts: Halo88 API (chapter 2), Alloy NTNX and MW386 (chapter 18). 


INTERRUPT 80h - Function 01h 


INITIALIZE 
Purpose: Prepare the PKTINT software for operation. 
Available on: All machines. Restrictions: QPC Software's PKTINT.COM must be 
installed. 
Registers at call: Return Registers: 
AH =0th AX = 0000h 
CX = FFFFh 
DX = FFFFh 


Details: This interrupt is the WinQVTNet protected mode interface to Windows 3.0. As part of the initialization, all 
buffer pointers are reset back to 0. 
Conflicts: Q-PRO4 (chapter 36), SoundBlaster SBFM (chapter 36). 


INTERRUPT 80h - Function 02h 


GET BUFFER ADDRESSES 

Purpose: Determine the addresses of the buffers used for sending and receiving data. 

Available on: All machines. Restrictions: QPC Software's PKTINT.COM must be 
installed. 

Registers at call: Return Registers: 

AH = 02h AX = segment address of 10K buffer (for receives) 

BX = extra bytes to allocate per packet BX = segment address of 2K buffer (for sends) 

Conflicts: Q-PRO4 (chapter 36), SoundBlaster SBFM (chapter 36). 

See Also: Function 05h 

INTERRUPT 80h - Function 03h 

GET ENTRY POINT 

Purpose: Determine address to be called on receipt of a packet from the network. 

Available on: All machines. Restrictions: QPC Software's PKTINT.COM must be 


installed. 
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Registers at call: Return Registers: 

AH = 03h CX:DX -> receive call address 

Details: The returned address can be used in the packet driver calls since it will be a valid address in all DOS boxes. 
Conflicts: Q-PRO4 (chapter 36), SoundBlaster SBFM (chapter 36). 

See Also: Function 06h 


INTERRUPT 80h - Function 04h 


ENABLE 

Purpose: Turn on PKTINT's functionality. 

Available on: All machines, Restrictions: QPC Software's PKTINT.COM must be 
installed, 

Registers at call: Return Registers: unknown. 

AH = 04h 

BX = unknown, 

Conflicts: Q-PRO4 (chapter 36), SoundBlaster SBFM (chapter 36). 

INTERRUPT 80h - Function 05h 

GET RECEIVE STATISTICS 

Purpose: Determine how much data has been received. 

Available on: All machines. Restrictions: QPC Software's PKTINT.COM must be 
installed. 

Registers at call: Return Registers: 

AH = 05h AX = amount of buffer currently in use 


BX = current offset in buffer 

CX = number of times receive has been called 
Conflicts: Q-PRO4 (chapter 36), SoundBlaster SBFM (chapter 36). 
See Also: Function 02h 


INTERRUPT 80h - Function 06h 


REMOVE RECEIVED PACKET 

Purpose: Indicate that the current packet has been processed, and that the caller is ready for the next. 

Available on: All machines. Restrictions: QPC Software's PKTINT.COM must be 
installed. 

Registers at call: Return Registers: 

AH = 06h BX = next packet offset 


CX = number of bytes still buffered 

DX = size of packet released back into buffer pool 
Conflicts: Q-PRO4 (chapter 36), SoundBlaster SBFM (chapter 36). 
See Also: Function 03h 


INTERRUPT 81h 


Unknown Function 


Purpose: unknown, 

Available on: All machines. Restrictions: IBM Token Ring Adapter software must 
be installed, 

Registers at call: unknown, Return Registers: unknown. 

Conflicts: Basic interpreter (chapter |). 


INTERRUPT 82h 

Unknown Function 

Purpose: unknown, 

Available on: All machines. Restrictions: IBM Token Ring Adapter software must 
be installed. 
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Registers at call: 
AH = function 
00h display message 
DS:BX -> string 
others, if any, unknown. 
Conflicts: Basic interpreter (chapter 1). 


INTERRUPT 86h 
ORIGINAL INT 18h 


Return Registers: unknown. 


Purpose: Some implementations of NetBIOS use this vector to store the original value of INT 18h. 


Available on: All machines, 


Restrictions: NetBIOS must be installed. 


Conflicts: Basic interpreter (chapter I), APL*PLUS/PC (chapter 31). 


INTERRUPT 91h 


Unknown Function 


Purpose: unknown. 
Available on: All machines. 


Registers at call: unknown, 
Conflicts: Basic interpreter (chapter 1). 


INTERRUPT 92h 
Sangoma X.25 INTERFACE PROGRAM 


Purpose: witknown. 
Available on: All machines. 


Registers at call: 
BX:DX -> control block 
Conflicts: BASIC interpreter (chapter 1). 


INTERRUPT 93h 


Unknown Function 


Purpose: unknown. 
Available on: All machines. 


Registers at call: unknown. 
Conflicts: BASIC interpreter (chapter 1). 


INTERRUPT Eth 


Unknown Function 


Purpose: unknown. 
Available on: All machines. 


Registers at call: unknown. 
Conflicts: BASIC interpreter (chapter 1), 


INTERRUPT E2h 


Unknown Function 


Purpose: unknown. 

Available on: All machines. 

Registers at call: unknown. 

Conflicts: BASIC interpreter (chapter 1). 


Restrictions: IBM Token Ring Adapter software must 
be installed. 
Return Registers: unknown. 


Restrictions: Sangoma X.25 interface program must 
be installed. 
Return Registers: unknown. 


Restrictions: IBM Token Ring Adapter software must 
be installed. 
Return Registers: saknown. 


Restrictions: PC Cluster Disk Server must be 
installed. 
Return Registers: unknown. 


Restrictions: PC Cluster Program must be installed. 
Return Registers: unknown. 
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Remote Control Software 





One class of software that has become invaluable to consultants and others who must troubleshoot systems from a 
distance is that which permits one computer to take full control of another at a remote location. By using such sys- 
tems, the troubleshooter can make a "house call" by telephone without having to travel anywhere. 

The two best known such systems are Carbon Copy and pcAnywhere. The interrupts used by these to provide re- 
mote control are described in this chapter, together with that of a third less widely known system, TeleReplica, and 
the new PC Tools version 7 COMMUTE. In addition, LapLink’s Quick Connect and DeskConnect are covered in 
this chapter even though they are file transfer utilities more than remote control software. 


Carbon Copy 

Carbon Copy is produced by Meridian Technology, Inc. 
INTERRUPT 10h - Function FFh, Subfunction 00h 
CHECK IF CC CONNECTED TO CCHELP 


Purpose: Determine whether a connection has been established to the remote machine. 


Available on: All machines. Restrictions: Carbon Copy Plus 5.0 must be installed. 
Registers at call: Return Registers: 
AX = FFOOh BL = 00h not connected 


= 01h connected 
Conflicts: None known. 


INTERRUPT 10h - Function FFh, Subfunction 01h 
DISCONNECT AND RESET LINE 


Purpose: Terminate the current connection. 


Available on: All machines. Restrictions: Carbon Copy Plus 5.0 must be installed. 
Registers at call: Return Registers: n/a 
AX = FEOIh 


Conflicts: None known, 


INTERRUPT 10h - Function FFh, Subfunction 02h 
GET LAST PHONE NUMBER DIALED 


Purpose: Determine with which machine a connection was last established or attempted. 


Available on: All machines. Restrictions: Carbon Copy Plus 5.0 must be installed. 
Registers at call; Return Registers: 

AX = FFO02h ES:DI - > ASCIZ phone number 

Conflicts: None known. 

COMMUTE 


One of the additions in PC Tools version 7 is a remote control program called COMMUTE, COMMUTE allows the 
machine it is run on to control another PC or be controlled by another PC, Features of COMMUTE include scripts, 
security control, and file transfers in addition to interactive remote control, 
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INTERRUPT 62h - Function 47h 
Unknown Function 


Purpose: unknown. 
Available on: All machines. 


Registers at call: 

AH = 47h 

AL = subfunction (00h-3 1h) 
CF set 

other unknown, 

Conflicts: See chapter 1. 


INTERRUPT 62h - Function 48h 


Unknown Function 


Purpose: unknown. 
Available on: All machines, 


Registers at call: 

AH = 48h 

AL = unknown. 

CF set 

other ratknown. 
Conflicts: See chapter 1. 


INTERRUPT 62h - Function 49h 
Unknown Function 


Purpose: unknown, 
Available on: All machines. 


Registers at call: 

AH = 49h 

CF set 

other unknown. 
Conflicts: See chapter 1. 


INTERRUPT 62h - Function 4Ah 
Unknown Function 


Purpose: unknown. 
Available on: All machines, 


Registers at call: 

AH = 4Ah 

AL = subfunction (00h-46h) 
CF set 

other unknown. 

Conflicts: See chapter 1. 


INTERRUPT 62h - Function 4Bh 


Unknown Function 


Purpose: unknown. 
Available on: All machines. 


Restrictions: PC Tools 7 COMMUTE must be 
installed, 
Return Registers: unknown. 


Restrictions; PC Tools 7 COMMUTE must be 
installed. 
Return Registers: unknown. 


Restrictions; PC Tools 7 COMMUTE must be 
installed. 
Return Registers: unknown. 


Restrictions; PC Tools 7 COMMUTE must be 
installed. 
Return Registers: unknown. 


Restrictions: PC Tools 7 COMMUTE must be 
installed. 
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Registers at call: Return Registers: unknown. 
AH =4Bh 

BX = 1234h 

CX = 1234h 

ES = unknown. 

CF set 

Conflicts: See chapter 1. 


INTERRUPT 62h - Function 4Ch 


Unknown Function 

Purpose: unknown. 

Available on: All machines. Restrictions: PC Tools 7 COMMUTE must be 
installed. 

Registers at call: Return Registers: 

AH = 4Ch CF set on error 

BL = subfunction (00h,02h,probably others) other unknown, 

CF set 

other unknown, 

Conflicts: See chapter 1. 

INTERRUPT 62h - Function 62h, Subfunction 62h 

INSTALLATION CHECK 

Purpose: Determine whether PC Tools 7 COMMUTE is installed. 

Available on: All machines. Restrictions: none. 

Registers at call: Return Registers: 

AX = 6262h AX = 0000h 

CF set BX = segment of resident code 

Conflicts: See chapter 1. 

LapLink 


LapLink was one of the first to provide high-speed file transfers between PCs with incompatible floppy disk drives 
using a direct connection. Quick Connect is distributed as part of PC Tools version 6; DeskConnect is distributed as 
part of PC Tools version 7. 


INTERRUPT 2Fh - Function D3h, Subfunction CBh 


LapLink API 
Purpose: Communicate with the LapLink file transfer programs. 
Available on: All machines, Restrictions: LapLink Quick Connect or DeskConnect 
must be installed. 
Registers at call: Return Registers: 
AX = D3CBh BX:AX -> unknown code or data. 
CX = function CL = unknown. 
0002h get configuration. CH = unknown. 
DX = unknown. 
DI=COML I/O port 
SI = COM2 I/O port 
0003h initialization CX = 534Bh 
0004h unknown. 
0005h initialization 
0006h reset/clear unknown flag/data AX = 0000h 


CX = 534Bh 
ES:DI -> next byte after value cleared by this call 
0007h initialization CX = 534Bh 
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0008h uninstall BX = status 
0000h successful 
FFFFh incomplete, stub remains in 
memory 
CX = 534Bh 
pcANYWHERE 


pcANY WHERE is a remote-control program by Dynamic Microprocessor Associates. 


INTERRUPT 16h - Function 75h 
SET TICK COUNT FOR SCANNING 


Purpose: Specify how often ppANY WHERE transmits screen changes to the controlling PC. 


Available on: All machines. Restrictions: pecANYWHERE III must be installed. 
Registers at call: Return Registers: n/a 
AH =75h 


AL = number of ticks between checks for new 
screen changes 
Conflicts: None known. 


INTERRUPT 16h - Function 76h 
SET ERROR CHECKING TYPE 


Purpose: Specify the error correction to be used on the connection between the two PCs. 
Available on: All machines, Restrictions: peANY WHERE III must be installed. 
Registers at call: Return Registers: n/a 
AH = 76h 
AL = error checking type 
00h none 
Olh fast 
02h slow 
Conflicts: None known. 


INTERRUPT 16h - Function 77h 
LOG OFF 


Purpose: Terminate the connection with a remote machine. 
Available on: All machines. Restrictions: ppeANY WHERE III must be installed. 
Registers at call: Return Registers: n/a 
AH =77h 
AL = mode 
00h wait for another call 
O1h leave in Memory Resident Mode 
02h leave in Automatic Made 
FFh leave in current operating mode 
Conflicts; WATCH.COM Installation Check (chapter 36), PC Magazine PUSHDIR.COM INSTALLATION 
CHECK (chapter 36). 


INTERRUPT 16h - Function 79h 





CHECK STATUS 

Purpose: Determine whether peANY WHERE III is loaded, and if so, how it was loaded. 
Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 

AH = 79h AX = status 


FFFFh if resident and active 
FFFEnh if resident but not active 
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FFFDh if in Memory Resident mode 
FFFCh if in Automatic mode 
other value if not resident 
Conflicts: None known. 
See Also: Function 7Bh Subfunction 00h, INT 21h Function 2Bh Subfunction 44h 


INTERRUPT 16h - Function 7Ah 
CANCEL SESSION 


Purpose: Abort the current connection. 


Available on: All machines. Restrictions: peANYWHERE III must be installed. 
Registers at call: Return Registers: n/a 
AH=7Ah 


Conflicts: None known. 


INTERRUPT 16h - Function 7Bh, Subfunction 00h 
SUSPEND 


Purpose: Temporarily disable ppANYWHERE to allow other uses of the serial port such as file transfers, 


Available on: All machines. Restrictions: peANY WHERE III must be installed. 
Registers at call: Return Registers: n/a 
AX = 7B00h 


Conflicts: None known. 
See Also: Function 79h, Function 7Bh Subfunction 01h 


INTERRUPT 16h - Function 7Bh, Subfunction 01h 
RESUME 


Purpose: Enable ppANY WHERE after other use of the serial port is complete. 


Available on: All machines. Restrictions: peANY WHERE III must be installed. 
Registers at call: Return Registers: n/a 
AX =7BO1h 


Conflicts: None known. 
See Also: Function 79h, Function 7Bh Subfunction 00h 


INTERRUPT 16h - Function 7Ch 
GET PORT CONFIGURATION 


Purpose: Determine which serial port and what speed peANY WHERE is using. 





Available on: All machines. Restrictions: peANY WHERE III must be installed. 

Registers at call: Return Registers: 

AH =7Ch AH = port number 

AL = baud rate 

OOh= 50 
Olh= 75 
O2h= 110 
O3h= 134.5 
O4h= 150 
05h= 300 
06h = 600 
07h = 1200 
O8h= 1800 
09h = 2000 
OAh = 2400 
OBh = 4800 


OCh = 7200 
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ODh = 9600 
OEh = 19200 


INTERRUPT 16h - Function 7Dh 
GET/SET TERMINAL PARAMETERS 


Purpose: Determine or specify the parameters to be used by the terminal emulation. 


Available on: All machines. Restrictions: ppeANY WHERE III must be installed, 
Registers at call: Return Registers: n/a 
AH =7Dh 


AL = subfunction 
00h set terminal parameters 
Oth get terminal parameters 
02h get configuration header and terminal 
parameters 
DS:CX -> terminal parameter block 
Conflicts: None known. 


INTERRUPT 16h - Function 7Eh 
COMMUNICATIONS /0 THROUGH PORT 


Purpose: Permit data transfer over the same serial port being used for remote control. 


Available on: All machines. Restrictions: pecANY WHERE IIT must be installed. 
Registers at call: Return Registers: n/a 
AH = 7Eh 
AL = subfunction 
Olh port input status 


Return AX = 0 if no character ready, 
AX = | if character ready 
02h port input character 
Return AL = received character 
03h port output character in CX 
1th hang up phone 
Conflicts: None known, 


INTERRUPT 16h - Function 7Fh 
SET KEYBOARD/SCREEN MODE 


Purpose: Specify which machine's keyboard is to be active, which portion of the screen to display, and what type of 
hardware is being used for the remote control connection. 


Available on: All machines. Restrictions: peANY WHERE III must be installed. 
Registers at call: Return Registers: n/a 
AH = 7Fh 


AL = subfunction 
00h enable remote keyboard only 
Olh enable host keyboard only 
02h enable both keyboards 
08h display top 24 lines 
09h display bottom 24 lines 
10h Hayes modem 
11h other modem 
12h direct connect 
Conflicts: None known. 
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INTERRUPT 21h - Function 2Bh, Subfunction 44h 
pcANYWHERE IV - INSTALLATION CHECK 


Purpose: Determine whether peANYWHERE IV is installed, and if so, the address to call in order to request 
services. 


Available on: All machines. Restrictions: none. 

Registers at call: Return Registers: 

AX = 2B44h (‘D') AX = 4F4Bh (‘OK’) if loaded and unknown condition 
BX = 4D4th (MA) = 6F6Bh (‘ok’) if loaded and unknown condition 
CX = 7063h (‘pe’) CX:DX -> API entry point 


DX = 4157h (AW) 
Details: Call the API entry point with: 
AX = 0000h unknown 

= 0003h suspend 

= 0004h resume 
Conflicts: PC Tools v5.1 PC-CACHE (chapter 6), DOS Set System Date (chapter 8), DESQview Installation Check 
(chapter 15), ELRES v1.1 (chapter 36), TAME (chapter 36). 
See Also: INT 16h Function 79h 


TeleReplica 


TeleReplica is a shareware remote control program by Douglas Thomson. 


INTERRUPT 2Fh - Function D3h, Subfunction 00h 


INSTALLATION CHECK 

Purpose: Determine whether TeleReplica is installed. 

Available on: All machines. Restrictions: none, 
Registers at call: Return Registers: 

AX = D300h SI = segment of resident code 
BX = 4562h AX = 251Dh 

CX = 2745h BX = DF2th 

DX = unknown. (03F8h for v3.9) CX = F321h 


DX = unknown. 
Conflicts: None known. 
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Communicating Applications Specification 





The DCA/Inte! Communicating Applications Specification was developed as a joint effort by Digital Communica- 
tions Associates, Inc., and Inte! Corporation. It was originally intended to define a standard, high-level programming 
interface for data communications applications, that would be independent of the hardware and software involved. It 
is rapidly becoming a de facto standard for fax modem applications; a recent industry survey showed that nearly half 
the fax-card vendors who responded claimed to use CAS-compliant software, while the remaining vendors were all 
using unique proprietary formats. 

To be CAS-compliant, a system must provide a “Resident Manager" (which may be either a conventional TSR, a 
device driver, or a Windows DLL) that supports the functions listed in this chapter. Applications then use these func- 
tions to communicate with the Resident Manager, which provides the actual hardware interfacing. 


INTERRUPT 2Fh - Function CBh, Subfunction 00h 


INSTALLATION CHECK 

Purpose: Determine whether a CAS-compliant driver is present. 

Available on: All machines. Restrictions: none. 

Registers at call: Return Registers: 

AX = CB00h AL = 00h not installed, OK to install 
Olh not installed, not OK to install 
FFh installed 


Details: CBh is the default multiplex number, but it may be reconfigured. 
Conflicts: None known. 
See Also: Function CBh Subfunction OEh 


INTERRUPT 2Fh - Function CBh, Subfunction 01h 


SUBMIT A TASK 

Purpose: Request that some action be performed at a later time. 

Available on: All machines. Restrictions: CAS-compliant driver must be installed. 
Registers at call: Return Registers: 

AX =CBOIh AX > = 0: event handle 

DS:DX -> ASCIZ name of task control file <0: error code (Table 29-1) 


Details: The files needed for an event must be kept until the task is complete or an error occurs, 
Conflicts: None known. 
See Also: Function CBh Subfunctions OBh and 15h 


Table 29-1. Values of Error Codes (AH = class, AL = subcode, value passed back is 2’s complement): 


Class Subcode Meaning 
00h --- FAX warnings 
00h no error 
02h bad scanline count 
03h page sent with errors, could not retransmit 
04h received data lost 
05h invalid or missing logo file 
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Table 29-1. Values of Error Codes (continued) 
Class Subcode Meaning 





06h filename does not match nonstandard format (NSF) header 
07h file size does not match NSF header 
Oth -~- DOS warnings (data was sent) 
Olh invalid function 
05h access denied 
06h invalid handle 
others see DOS INT 21h Function 59h (chapter 8) 
02h -~ fatal errors (data not sent) 
00 multiplex handler failed 
Olh unknown command 
02h bad event handle 
03h FIND NEXT attempted before FIND FIRST 
04h no more events 
07h invalid queue type 
08h bad control file 
09h communication board busy 
OAh invalid command parameter 
OBh can't uninstall resident code 
0Ch file exists 
80h unknown task type 
81h bad phone number 
82h bad .PCX file header 
83 unexpected EOF 
84h unexpected disconnect 
85h too many dialing retries 
86h no file specified for send 
87h communication board timeout 
88h received too many pages (>1023) of data 
89h manual connect initiated too long ago 
8Ah hardware command set error 
8Bh bad NonStandard Format (NSF) header file 
03h +=: fatal DOS errors 
02h file not found 
03h path not found 
others see INT 21h Function 59h (chapter 8) 
04h ~-- FAX errors 
Oth remote unit not Group 3 compatible 
02h remote unit did not send capabilities 
03h other FAX machine incompatible 
04h other FAX incapable of file transfers 
05h exceeded retrain or FAX resend limit 
06h line noise or failure to agree on bit rate 
07h remote disconnected after receiving data 
O8h no response from remote after sending data 
09h remote's capabilities incompatible 
OAh no dial tone (v1.2+) 
OBh invalid response from remote unit after sending data 
ODh phone line dead or remote unit disconnected 
OEh timeout while waiting for secondary dial tone (v1.2+) 
Tih invalid command from remote after receiving data 
15h tried to receive from incompatible hardware 
5Ch received data overflowed input buffer 
SDh remote unexpectedly stopped sending data 
5Eh other FAX machine jammed (no data sent) 


SFh remote took too long to send fax scan line 





Communicating Applications Specification 29-3 


Table 29-1. Values of Error Codes (continued) 


Class Subcode Meaning 
63h can't get through to remote unit 
64h user canceled event 
05h -~- application-specific (v1.2+) 
~--Intel FAXPOP.EXE 
00h tried to send while in graphics mode 
Olh insufficient disk space 
02h internal buffer overflow 


06h -~- CAS implementation-specitic (v1.2+) 


INTERRUPT 2Fh - Function CBh, Subfunction 02h 
ABORT CURRENT EVENT 
Purpose: Terminate the event currently in progress. 
Available on: All machines. Restrictions: CAS-compliant driver must be installed. 
Registers at call: Return Registers: 
AX = CB02h AX >= 0: event handle of aborted event 
<0: error code (see Table 29-1) 
Details: Termination could take up to 30 seconds. 
Conflicts: None known, 
See Also: Function CBh Subfunctions 08h and 10h 


INTERRUPT 2Fh - Function CBh, Subfunction 05h 


FIND FIRST QUEUE ENTRY 
Purpose: Retrieve the first event matching the specified criteria. 
Available on: All machines. Restrictions: CAS-compliant driver must be installed. 
Registers at call: Return Registers: 
AX = CBOSh AX = 0000h successful 
CX = status of events to find BX = event handle for found event 
0000h successful completion <0 error code (see Table 29-1) 


0001h waiting to be processed 
0002h number has been dialed 
0003h connection established, sending 
0004h connection established, receiving 
0005h event aborted 
FFFFh find any event, regardless of status 
other negative values, match error code 
DH = direction 
00h chronological order, earliest to latest 
Oth reverse chronological order, latest to 
earliest 
DL = queue to search 
00h task queue 
Oh receive queue 
02h log queue 
Conflicts: None known. 
See Also: Function CBh Subfunctions 06h and 07h 


INTERRUPT 2Fh - Function CBh, Subfunction 06h 
FIND NEXT QUEUE ENTRY 


Purpose: Retrieve the next event matching previously specified criteria. 
Available on: All machines. Restrictions: CAS-compliant driver must be installed. 
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Registers at call: Return Registers: 

AX = CB06h AX = 0000h successful 

DL = queue to search BX = event handle for found event 
00h task queue <0 error code (see Table 29-1) 


Oth receive queue 

02h log queue 
Details: The direction of search is the same as for the preceding FIND FIRST call. 
Conflicts: None known. 
See Also: Function CBh Subfunction 05h 


INTERRUPT 2Fh - Function CBh, Subfunction 07h 


OPEN FILE 
Purpose: Prepare to read a received file or a control file. 
Available on: All machines. Restrictions: CAS-compliant driver must be installed. 
Registers at call: Return Registers: 
AX = CBO7h AX = 0000h successful 
BX = event handle from find (Subfunctions 05h or BX = DOS file handle for requested file 
O6h) or submit task (Subfunction 01h) <0 error code (see Table 29-1) 


CX = receive file number (ignored for task queue 
and log queue) 
0000h open receive control file 
N__ open Nth received data file 
DL = queue 
00h task queue 
Olh receive queue control file or received file, 
as given by CX 
02h log queue 
03h group file in task queue (v1.2+) 
04h group file in log queue (v1.2+) 
Details: The returned file handle has been opened in read-only mode and should be closed with DOS INT 21h 
Function 3Eh (chapter 8) after use. 
Conflicts: None known. 
See Also: Function CBh Subfunctions 01h, 05h, and 14h 


INTERRUPT 2Fh - Function CBh, Subfunction 08h 


DELETE FILE 

Purpose: Erase a control file or received data file which is no longer needed. 

Available on: All machines. Restrictions: CAS-compliant driver must be installed, 
Registers at call: Return Registers: 

AX = CBO8h AX = 0000h successful 

BX = event handle <0 error code (see Table 29-1) 


CX = receive file number 
0000h delete ALL received files and receive 
control file 
N_ delete Nth received file 
DL = queue 
00h delete control file in task queue and 
corresponding group file if it exists 
Olh delete file in receive queue, as given by CX 
02h delete control file in log queue (individual 
deletions not recommended, to maintain 
integrity of log) and corresponding group 
file if it exists 
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Conflicts: None known, 
See Also: Function CBh Subfunctions 02h and 09h 


INTERRUPT 2Fh - Function CBh, Subfunction 09h 
DELETE ALL FILES IN QUEUE 

Purpose: Erase all files of a particular type. 

Available on: All machines. Restrictions: CAS-compliant driver must be installed. 
Registers at call: Return Registers: 

AX = CB09h AX = 0000h successful 


DL = queve <0 error code (see Table 29-1) 


00h delete all control files in task queue, 
including all group files 
Oth delete all files in receive queue 
02h delete all control files in log queue, 
including all group files 
Conflicts: None known. 
See Also: Function CBh Subfunction 08h 


INTERRUPT 2Fh - Function CBh, Subfunction 0Ah 


GET EVENT DATE 
Purpose: Determine the day on which the specified event will occur. 
Available on: All machines. Restrictions: CAS-compliant driver must be installed. 
Registers at call: Return Registers: 
AX =CBOAh AX = 0000h successful 
BX = event handle CX = year 
DL = queue DH = month 
00h task queue DL =day 
Olh receive queue AX < Qerror code (see Table 29-1) 


02h log queue 
Conflicts: None known, 
See Also: Function CBh Subfunctions 0Bh and 0Ch 


INTERRUPT 2Fh - Function CBh, Subfunction 0Bh 


SET TASK DATE 

Purpose: Specify the date on which the indicated task should be performed. 

Available on: All machines. Restrictions: CAS-compliant driver must be installed. 
Registers at call: Return Registers: 

AX = CBOBh AX = 0000h successful 

BX = event handle (task event only) AX < Oerror code (see Table 29-1) 

CX = year 

DH = month 

DL = day 


Details: Setting a task's date and time to before the current date and time causes it to execute immediately. 
Conflicts: None known. 
See Also: Function CBh Subfunctions 01h, OAh, and ODh 


INTERRUPT 2Fh - Function CBh, Subfunction 0Ch 


GET EVENT TIME 

Purpose: Determine the time of day at which the specified event will occur. 

Available on: All machines. Restrictions: CAS-compliant driver must be installed. 
Registers at call: Return Registers: 

AX = CBOCh AX = 0000h successful 


BX = event handle CH = hour 
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DL = queue CL = minute 
00h task queue DH = second 
O1h receive queue DL = 00h 
02h log queue AX < Oerror code (see Table 29-1) 


Conflicts; None known. 
See Also: Function CBh Subfunctions 0Ah and ODh 


INTERRUPT 2Fh - Function CBh, Subfunction 0Dh 


SET TASK TIME 

Purpose: Specify the time of day at which the indicated task should be performed. 

Available on: All machines. Restrictions: CAS-compliant driver must be installed. 
Registers at call: Return Registers: 

AX = CBODh AX = 0000h successful 

BX = event handle (task events only) AX < Oerror code (see Table 29-1) 

CH = hour 

CL = minute 

DH = second 

DL unused 


Details: Setting a task’s date and time to before the current date and time causes it to execute immediately. 
Conflicts: None known. 
See Also: Function CBh Subfunctions OBh, OCh, and 10h 


INTERRUPT 2Fh - Function CBh, Subfunction 0Eh 
GET EXTERNAL DATA BLOCK 


Purpose: Retrieve the CAS version, the names of various data files, and the identification of the attached FAX 
device, 


Available on: All machines. Restrictions: CAS-compliant driver must be installed. 
Registers at call; Return Registers: 

AX = CBOEh AX = 0000h successful 

DS:DX -> 256-byte buffer (Table 29-2) buffer filled 


AX < Oerror code (see Table 29-1) 
Conflicts: None known. 


Table 29-2. Format of External Data Block: 


Offset Size Description 

00h BYTE CAS major version 

Olh BYTE CAS minor version 

02h 68 BYTEs ASCIZ path to directory containing CAS software, ends in slash 

46h 13 BYTEs ASCIZ name of current phonebook (in CAS directory) 

53h 13 BYTEs ASCIZ name of current logo file (in CAS directory) 

60h 32 BYTEs ASCIZ default sender name 

80h 21 BYTEs ASCIZ CCITT identification of fax device 

95h 107 BYTEs reserved 

INTERRUPT 2Fh - Function CBh, Subfunction OFh 

GET/SET AUTORECEIVE 

Purpose: Specify or determine whether the FAX will automatically answer incoming calls. 
Available on: All machines. Restrictions: CAS-compliant driver must be installed. 
Registers at call: Return Registers: 

AX = CBOFh AX = 0000h autoreceive disabled 

DL = subfunction = Nnumber of rings before answer 


00h get current autoreceive state < 0 error code (see Table 29-1) 
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Olh set autoreceive state 
DH = number of rings before answer, 00h = never 


Conflicts: None known. 


INTERRUPT 2Fh - Function CBh, Subfunction 10h 
GET CURRENT EVENT STATUS 


Purpose: Determine whi 
Available on: All machines. 


Registers at call: 


AX =CB10h 


DS:DX -> 512-byte buffer (Table 29-3) 


Conflicts: None known. 


ich event is currently executing and what its status is. 
Restrictions: CAS-compliant driver must be installed. 


Return Registers: 
AX = 0000h successful 


error code if no current event 
buffer filled 
AX < error code (see Table 29-1) 


See Also: Function CBh Subfunctions 02h and ODh 


Table 29-3. Format of Status Area: 


Offset 
00h 


Olh 


02h 


04h 
06h 


08h 
OAh 
0Ch 
3Bh 
7Bh 
7Ch 
7Dh 


Size 
BYTE 


BYTE 


WORD 


WORD 
WORD 


WORD 
WORD 
47 BYTEs 
64 BYTEs 
BYTE 
BYTE 
BYTE 


Description 
event type: 
00h send 
Olh receive 
02h polled send 
03h polled receive 
04h to 7Fh reserved 
FFh serious hardware error 
transfer type: 
00h 200x200 dpi, FAX mode 
O1h 100x200 dpi, FAX mode 
02h file transfer mode 
03h to 7Fh reserved 
event status: 
0000h completed successfully 
000th waiting 
0002h number dialed 
0003h connected, sending 
0004h connected, receiving 
0005h aborted 
0006h to 007Fh reserved 
0080h to 7FFFh application-specific events 
8000h to FFFFh error codes 
event time (packed DOS time format, see INT 21h Function 57h Subfunction 00h, 
chapter 8) 
event date (packed DOS date format, see INT 21h Function 57h Subfunction 00h, 
chapter 8) 
number of files to transfer, max 7FFFh 
offset of file transfer record 
ASCIZ phone number to call 
ASCIZ application-specific tag string 
reserved (00h) 
connect time, seconds 
connect time, minutes 


BX = event handle of current event or negative 
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Table 29-3. Format of Status Area (continued) 


Offset Size Description 

7Eh BYTE connect time, hours 

7Fh DWORD total number of pages in all files 
83h DWORD pages already transmitted 

87h WORD number of files already transmitted 
89h BYTE cover page flag: 


00h don't transmit cover page 
Oth transmit cover page 


02h to 7Fh reserved 
8Ah WORD total number of transmission errors 
8Ch 78 BYTEs reserved (zeros) 
DAh 21 BYTEs ASCIZ remote FAX's CCITT identification 
EFH 32 BYTEs ASCIZ destination name 
10Fh 32 BYTEs ASCIZ sender name 
12Fh 80 BYTEs filename of PCX logo file (max 1780x800 pixels) 
17Fh 128 BYTEs file transfer record for current event (Table 29-4) 


Table 29-4, Format of File Transfer Record: 


Offset Size Description 
00h BYTE file type (ignored unless FAX): 
00h ASCII 
Olh PCX 
02h DCX 
03h to 7Fh reserved 
Olh BYTE text size for ASCII FAX file: 


00h = 80 columns by 66 lines (11 inches) 
O1h = 132 columns by 88 fines (11 inches) 
02h to 7Fh reserved 

02h BYTE status of file: 
00h untouched 
O1h opened 
02h moved 
03h deleted 
04h not yet received 
05h to 7Fh reserved 





03h DWORD bytes already transmitted 

07h DWORD file size in bytes 

OBh WORD pages alread transmitted 

0Dh WORD number of pages in file 

OFh 80 BYTEs ASCIZ filename 

5Fh BYTE 1/8 inch page length. If page length below set to 01h through 7Fh, this value specifies 
additional 1/8 inch increments to page length 

60h BYTE page length: 


00h = 11 inches 
Oth to 7Fh = page length is this number of inches plus value of 1/8 inch field 
above 
80h to FEh reserved 
FFh = ASCII pages ending with formfeed 
6Ih 31 BYTEs reserved (zeros) 


INTERRUPT 2Fh - Function CBh, Subiunction 11h 
GET QUEUE STATUS 


Purpose: Determine the state of the specified queue. 
Available on: All machines. Restrictions: CAS-compliant driver must be installed. 
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Registers at call: Return Registers: 

AX=CBIIh AX >=0 — total number of changes made to queue, 

DL = queue to get status of modulo 32768 
00h task queue BX = number of control files currently in queue 
Olh receive queue CX = number of received files (zero for task and 
02h log queue log queues) 


AX < Oerror code (see Table 29-1) 


Conflicts: None known. 
See Also: Function CBh Subfunction 12h 


INTERRUPT 2Fh - Function CBh, Subfunction 11h 
GET NUMBER OF SEND EVENTS 


Purpose: Determine how many times transmissions were attempted and how many were successful. 


Available on: All machines. Restrictions: CAS 1.2-compliant driver must be 
installed. 

Registers at call: Return Registers: 

AX=CBIlh AX = number of successful sends since resident 

DL = 03h manager started 


BX = number of unsuccessful sends, including 
warnings 
Conflicts: None known, 
See Also: Function CBh Subfunction | 1h/DL=04h 


INTERRUPT 2Fh - Function CBh, Subfunction 11h 
GET NUMBER OF RECEIVE EVENTS 


Purpose: Determine how many files and faxes have been received, 


Available on: All machines. Restrictions: CAS 1.2-compliant driver must be 
installed. 

Registers at call: Return Registers: 

AX =CBIIh AX = number of received file events since resident 

DL = 04h manager started 


BX = number of received FAX events 


Conflicts: None known, 
See Also: Function CBh Subfunction {1h/DL=03h 


INTERRUPT 2Fh - Function CBh, Subfunction 12h 


GET HARDWARE STATUS 

Purpose: Determine the current state of the FAX hardware. 

Available on: All machines. Restrictions: CAS-compliant driver must be installed. 
Registers at call: Return Registers: 

AX = CBI2h AX = 0000h successful 

DS:DX -> 128-byte status buffer (Tables 29-5, 29- buffer filled with hardware-dependent status 

6) information 


AX < Oerror code (see Table 29-1) 


Conflicts: None known. 
See Also: Function CBh Subfunctions 10h and 1h 


Table 29-5, Format of Status Buffer for Intel Connection CoProcessor: 


Offset Size Description 

00h BYTE bit flags: 
bit 7: hardware busy sending or receiving 
bit 6: last page of data 
bit 5: no data on current page 
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Table 29-5. Format of Status Buffer for Intel Connection CoProcessor (continued) 


Offset Size Description 
bit 4: retransmit request for current page being transmitted 
bit 3: NSF mode active 
bits 2-0: reserved 
Olh BYTE number of kilobytes of free buffer space 
02h BYTE page buffer status: 
bit 7: Connection CoProcessor has documents to send 
bits 6-0: number of pages in buffer 


03h BYTE number of retries left for dialing number 
04h BYTE page number to retransmit 
05h BYTE communications status 


bit 7: originating call 
bit 6: FAX message to be sent 
bit 5: on line 
bit 4: ring detected and receive enabled 
bit 3: buffer dumped on receive 
bits 2-0: hardware sequence state 

000 idle 

001 dial 

010 answer 

011 transmit 

100 receive 

101 pre-message 

110 post-message 

111 disconnect 


06h BYTE baud rate 
bit 7: reserved 
bits 6-4: baud rate 
000 = 300 baud (V.21 SDLC or HDLC made) 
100 = 2400 baud (V.27 ter) 
101 = 4800 baud (V.27 ter) 
110 = 7200 baud (V.29) 
111 = 9600 baud (V.29) 
bits 3-0: reserved, should be 0110 
O7h 3BYTEs reserved 
OAh BYTE hardware status 


bit 7: modem option installed 

bit 6: Connection CoProcessor has control of DAA (not latched) 

bit 5: on line (not latched) 

bit 4: ring detected (not latched) 

bit 3: data in command buffer (not latched) 

bit 2: set if using DMA channel 1, clear if using DMA channel 3 

bit I: line length compensation bit | set (not latched) 

bit 0: line length compensation bit 0 set (not latched) 

OBh BYTE switch states 

bit 7: reserved 

bit 6; unused 

bit 5: spare switch open 

bit 4: FAX ADRI switch open 

bit 3: FAX ADRO switch open 

bit 2: alternate interrupt switch open 

bit 1: COM SEL 1 switch open 

bit 0: COM SEL 0 switch open 

Note: valid combinations of bits 0-2 are 

000 COM2 IRQ3 IObase 2F8h 
001 COM1 IRQ4 IObase 3F8h 
010 COM4 IRQ3 IObase 2E8h 
011 COM3 IRQ4 IObase 3E8h 
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Table 29-5. Format of status buffer for Intel Connection CoProcessor (continued) 


Offset Size Description 
110 COM4 IRQ2 [Obase 2E8h 


111 COM3 IRQS [Obase 3E8h 

0Ch BYTE bit flags 

bit 7: reserved 

bit 6: auxiliary relay forced ON 

bit 5: modem select relay forced ON 

bit 4: offhook relay forced ON 

bit 3: 9600 bps enabled 

bit 2: 7200 bps enabled 

bit 1: 4800 bps enabled 

bit 0: 2400 bps enabled 
ODh BYTE reserved 


OEh WORD error count (only valid while busy, reset when idle) 
10h DWORD _ size of nonstandard format (NSF) file in bytes 

14h BYTE ‘A’ if Connection CoProcessor board present 

15h 9BYTEs reserved 

1Eh 21 BYTEs ASCIZ CCITT identification 

33h 71 BYTEs reserved 


Table 29-6. Format of status buffer for Intel SatisFAXion board: 


Offset Size Description 
00h BYTE connection status flags 
bit 7: busy in T.30 CCITT fax protocol 
bit 6: data on current page/file (only used for block xfers) 
bit 5: retransmission of last page requested 
bit 4: in file transfer mode 
bit 3: data in buffer 
bit 2: data buffer dumped on receive 
bit 1: 200x100 dpi resolution instead of 200x200 dpi 
bit 0: data modem in use, FAX image modem not available 
Olh BYTE board state 
bit 7: reserved 
bit 6; handset jack active, data and FAX modems not available 
bits 5-3: current bit rate 
000 300 bps (V.21 HDLC) 
100 2400 bps (V.27 ter) 
101 4800 bps (V.27 ter) 
110 7200 bps (V.29) 
111 9600 bps (V.29) 
bits 2-0: T.30 CCITT protocol state 
000 idle 
001 dialing 
010 answering 
O11 transmitting 
100 receiving 
101 pre-message 
110 post-message 
111 disconnect 


02h BYTE number of KB free in buffer 

03h BYTE number of pages or files in buffer 

04h BYTE number of redials remaining on current number 

05h BYTE FAX page number to retransmit 

06h BYTE current page/file in block transfer 

07h BYTE number of rings received (only if auto-answer enabled) 


08h WORD error count 
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Table 29-6. Format of Status Buffer for intel SatisFAXion board (continued) 


Offset Size Description 

OAh DWORD length of file being transferred 

OEh 6BYTEs reserved 

14h BYTE 'B' if SatisFAXtion board present 

15h 13 BYTEs ASCIZ transfer agent name 

22h SBYTEs ASCIZ transfer agent version number 
27h 13 BYTEs ASCIZ resident loader name 

34h SBYTEs ASCIZ resident loader version number 
39h 21 BYTEs ASCIZ remote CSID 

4Eh 13. BYTEs ASCIZ resident manager name 

SBh SBYTEs ASCIZ resident manager version number 
60h 32 BYTEs reserved 


Details: The Intel Connection CoProcessor and SatisFAXtion may be distinguished by examining the byte at offset 
14h. 


INTERRUPT 2Fh - Function CBh, Subfunction 13h 
GET DIAGNOSTICS RESULTS 


Purpose: Determine whether the hardware passed its diagnostics. 


Available on: All machines. Restrictions: CAS-compliant driver must be installed. 
Registers at call: Return Registers: 

AX=CB13h AX = 0040h in progress 

DL=00h >=0 passed 


<0 hardware-dependent failure code 
(Tables 29-7, 29-8) 
Conflicts: None known. 
See Also: Function CBh Subfunction 13h/DL=01h 


Table 29-7. Values of Intel Connection CoProcessor failure codes: 


bit 3: 9600 bps FAX madem module failed 
bit 2: SDLC chip failed 

bit L: RAM failed 

bit 0: ROM checksum failed 


Intel SatisFA Xtion:failure codes; 
.i.CAS:error codes; 

.ierror codes:CAS; 

.i.error codes:Intel SatisFAXtion; 


Table 29-8. Values of Intel SatisFAXion failure codes: 
bit 1: 2400 bps data modem failed 

bit 0: 9600 bps FAX modem failed 

CAS: diagnostics; 

«INT 2Fh:Function CBh; 

Multiplex function CBh:subfunction 13h; 


INTERRUPT 2Fh - Function CBh, Subfunction 13h 


START DIAGNOSTICS 

Purpose: Request that diagnostics be performed on the FAX hardware. 

Available on: All machines. Restrictions: CAS-compliant driver must be installed. 
Registers at call: Return Registers: 

AX=CB13h AX = 0000h successfully started 

DL=0Olh <0 error code (see Table 29-1) 


Conflicts: None known. 
See Also: Function CBh Subfunction 13h/DL=00h 
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INTERRUPT 2Fh - Function CBh, Subfunction 14h 
MOVE RECEIVED FILE 


Purpose: Specify a new name for a file received from another system. 


Available on: All machines. Restrictions: CAS-compliant driver must be installed. 


Registers at call: 


AX = CB14h 


BX = event handle 


CX = receive file number 


Return Registers: 
AX = 0000h successful 
<0 error code (see Table 29-1) 


0001h first received file 
N Nth received file 

DS:DX -> ASCIZ string specifying new name for 
file (must not exist) 


INTERRUPT 2Fh - Function CBh, Subfunction 15h 


SUBMIT FILE 


TO SEND 


Purpose: Request that the specified file be sent at the indicated time to the given destination. 


Available on: All machines. 


Registers at call: 


AX =CBI5h 
DS:DX -> variable-length data area (Table 29-9) 


Conflicts: None known. 
See Also: Function CBh Subfunction O1h 


Return Registers: 
AX >= 0 event handle 
<0 error code (see Table 29-1) 


Table 29-9. Format of Data Area: 


Offset 
00h 


Olh 


02h 
04h 


06h 
26h 
76h 
ASh 
E5h 
E6h 


E7h 
FEh 


Size 
BYTE 


BYTE 


WORD 
WORD 


32 BYTEs 
80 BYTEs 
47 BYTEs 
64 BYTEs 
BYTE 
BYTE 


23 BYTEs 
variable 


Description 
transfer type: 
00h = 200x200 dpi, fax mode 
O1h = 100x200 dpi, fax mode 
02h = file transfer mode 
03h to 7Fh reserved 
text size: 
00h = 80 columns 
O1h = 132 columns 
02h to 7Fh reserved 
time to send (DOS packed time format, see INT 21h Function 57h Subfunction 
00h, chapter 8) 
date to send (DOS packed date format, see INT 21h Function 57h Subfunction 
00h, chapter 8) 
ASCIZ destination name 
ASCIZ name of file to send 
ASCIZ phone number to dial 
ASCIZ application-specitic tag string 
reserved (00h) 
cover page: 
00h don't send cover page 
Olh send cover page 
02h to 7Fh reserved 
reserved (zeros) 
ASCIZ string containing text of cover page (if cover page flag set to Oth) 


INTERRUPT 2Fh - Function CBh, Subfunction 16h 
UNLOAD RESIDENT MANAGER 


Purpose: Attempt to remove the CAS driver from memory. 


Restrictions: CAS-compliant driver must be installed, 
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Available on: All machines. Restrictions: CAS 1,2-compliant driver must be 
installed. 

Registers at call: Return Registers: 

AX =CB16h AX = 0000h successful 

BX = 1234h <0 error code 

CX = 5678h 

DX = 9ABCh 


Conflicts: None known. 
See Also: Function CBh Subfunction 00h 


INTERRUPT 2Fh - Function CBh, Subfunction 17h 


SET COVER PAGE STATUS 
Purpose: Specify whether a cover page should be sent ahead of the indicated transmission. 
Available on: All machines. Restrictions: CAS 1.2-compliant driver must be 
installed. 
Registers at call: Return Registers: 
AX =CBI7h AX = 0000h successful 
BX = event handle <0 error code 
CL = cover page status 
00h not read 
Olh read by user 


Conflicts: None known. 
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Intel Image Processing Interface 


The Image Processing Interface permits communication with Intel’s printer controller products such as the Visual 
Edge. 


INTERRUPT 2Fh - Function CDh, Subfunction 00h 


INSTALLATION CHECK 

Purpose: Determine whether Image Processing Interface is installed. 

Available on: All machines. Restrictions: none. 

Registers at call: Return Registers: 

AX = CDOO0h AL = 00h not installed, OK to install 
O1h not installed, not OK to install 
FFh installed 

Conflicts: SWELL.EXE (chapter 36). 

INTERRUPT 2Fh - Function CDh, Subfunction 01h 

SET DEVICE NAME 

Purpose: Specify which device is to receive the printed output. 

Available on: All machines. Restrictions: Image Processing Interface must be 

installed. 

Registers at call: Return Registewrs: 

AX =CDOth AL = 00h successful 

CX:BX - > ASCIZ character device name ("LPTn", CX:BX -> internal character device name 

"COMn", "PRN") = 80h error 


Conflicts: SWELL.EXE (chapter 36). 


INTERRUPT 2Fh - Function CDh, Subfunction 02h 


GET VERSION NUMBER 

Purpose: Determine which version of the Image Processing Interface is present, 

Available on: All machines, Restrictions: Image Processing Interface must be 
installed. 

Registers at call: Return Registers: 

AX = CD02h AL = 00h/01h successful 


BH = major version number (BCD) 
BL = minor version number (BCD) 
= 80h error 
Details: If AL = 01h on return, the IPI supports network redirection, 
Conflicts: SWELL.EXE (chapter 36). 


INTERRUPT 2Fh - Function CDh, Subfunction 03h 


SELECT SCAN LINE 
Purpose: Specify which scan line following function calls should manipulate. 
Available on: All machines. Restrictions: Image Processing Interface must be 


installed. 


30-1 
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Registers at call: Return Registers: 
AX = CDO03h AL = 00h succesful 
BX = scan line CX = density at which scan line was mapped 
CX = requested density in dots per inch (300, 600, ES:DI -> start of scan line 
or 1200) AL = 80h unsuccessful 


= 81h scan line out of range 
= 82h unsupported scan line density 
= 83h out of memory 

Conflicts: SWELL.EXE (chapter 36). 


INTERRUPT 2Fh - Function CDh, Subfunction 04h 


MOVE BITMAP TO SCANLINE 

Purpose: Copy a portion of a graphic to the in-memory image of the current page. 

Available on: All machines. Restrictions: Image Processing Interface must be 
installed. 

Registers at call: Return Registers: 

AX = CD04h AL = 00h successful 

CX:BX -> bitmap structure (Table 30-1) = 80h unsuccessful 


= 81h scan line out of range 
= 82h unsupported scan line density 
= 83h out of memory 
= 84h unrecognized source 
= 85h initialization error 
Conflicts: SWELL.EXE (chapter 36). 


Table 30-1. Format of Bitmap Structure: 


Offset Size Description 

00h WORD image source (0 = conventional memory, | = expanded memory) 
02h DWORD pointer to image data 

06h WORD scan line on which to place 

08h WORD bit offset from start of scan line at which to place 

OAh WORD density of bitmap data (300, 600, or 1200 dpi) 

0Ch WORD width in bits of data 

OEh WORD source logical page number 

10h WORD source handle (only if source in expanded memory) 

12h WORD source offset (only if source in expanded memory) 
INTERRUPT 2Fh - Function CDh, Subfunction 05h 

PRINT PAGE 
Purpose: Output the final image of a page to the printer. 
Available on: All machines. Restrictions: Image Processing Interface must be 

installed. 

Registers at call: Return Registers: 
AX = CD05h AL = 00h successful 


= 80h unsuccessful 
Details: Page image is retained, so multiple calls will print multiple copies of the page. 
Conflicts: SWELL.EXE (chapter 36). 


INTERRUPT 2Fh - Function CDh, Subfunction 06h 

CLEAR PAGE 

Purpose: Erase the in-memory image of the current page. 

Available on: All machines. Restrictions: Image Processing Interface must be 
installed. 
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Registers at call: Return Registers: 
AX = CD06h AL = 00h successful 

= 80h unsuccessful 
Details: Palette is reset to default. 
Conflicts: SWELL.EXE (chapter 36). 


INTERRUPT 2Fh - Function CDh, Subfunction 07h 


Reserved Function 

Purpose: This function has been reserved by Intel and should not be called. 

Available on: All machines. Restrictions: Image Processing Interface must be 
installed. 

Registers at call: Return Registers: unknown. 

AX = CDO7h 

Conflicts: SWELL.EXE (chapter 36). 

INTERRUPT 2Fh - Function CDh, Subfunction 08h 

SCREEN IMAGE 

Purpose: Display a preview of the current page image. 

Available on: All machines. Restrictions: Image Processing Interface must be 
installed. 

Registers at call: Return Registers: 

AX =CDO8h AL = 00h successful 

CX:BX -> image structure (Table 30-2) = 80h unsuccessful 


= 81h scan line out of range 
= 82h unsupported scan line density 
= 83h out of memory 
= 84h unrecognized source 
= 85h initialization error 
Conflicts: SWELL.EXE (chapter 36). 


Table 30-2. Format of Image Structure: 











Offset Size Description 

00h WORD image source (0 = conventional memory, | = expanded memory) 
02h DWORD _ pointer to image data 

06h WORD horizontal position on paper of left edge (in 1200 dpi units) 
08h WORD vertical position on paper of top edge (in 1200 dpi units) 
OAh WORD left cropping (currently must be zero) 

0Ch WORD top cropping (currently must be zero) 

OEh WORD width (currently must be 8000h) 

10h WORD height (currently must be 8000h) 

12h WORD horizontal size of image in 1200 dpi units 

14h WORD vertical size of image in 1200 dpi units 

16h WORD aspect ratio (currently reserved) 

18) WORD initialization flag (if Oth, initialization is performed) 

1Ah WORD pixels per line of source data 

1Ch WORD number of scan lines in source data 

1Eh WORD number of scan fines in packet 

20) WORD bits per pixel (1,2,4,6, or 8) 

22h WORD pixels per byte (1,2,4, or 8) 

24h WORD compression type (currently only 00h [uncompressed] supported) 
261 WORD source page number (if in expanded memory) 

28h WORD source handle (if in expanded memory) 

2Ah WORD source offset (if in expanded memory) 
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INTERRUPT 2Fh - Function CDh, Subfunction 09h 


LOAD SCREEN 

Purpose: Specify the style, size, and angle of the half-toning screen to be used when printing. 

Available on: All machines. Restrictions: Image Processing Interface must be 
installed, 

Registers at call: Return Registers: 

AX =CD09h AL = 00h successful 

CX:BX -> half-toning screen structure (Table 30-3) = 80h unsuccessful 


Conflicts: SWELL.EXE (chapter 36). 
See Also: Function CDh Subfunction 0Ah 


Table 30-3. Format of Half-toning Screen Structure: 


Offset Size Description 
00h BYTE style; 44h ('D') diamond style 
ACh ('L’) line style 
Olh BYTE reserved (00h) 
02h WORD frequency in lines per inch, Currently coerced to nearest of 50, 60, 68, 70, 75, 85, or 100 
04h WORD screen angle in degrees (-360 to 360) 


currently coerced to nearest of -45, 0, 45, or 90 


INTERRUPT 2Fh - Function CDh, Subfunction 0Ah 


LOAD PALETTE 

Purpose: Specify the correspondence between pixel values and colors. 

Available on: Ail machines. Restrictions: Image Processing Interface must be 
installed. 

Registers at call: Return Registers: 

AX = CDOAh AL = 00h successful 

CX:BX -> palette structure (Table 30-4) = 80h unsuccessful 

Conflicts: SWELL.EXE (chapter 36). 

See Also: Function CDh Subfunction 09h 

Table 30-4, Format of Palette Structure: 

Offset Size Description 

00h BYTE bits per pixel for which palette is to be used (1,2,4,6, or 8) 


Oih 2**N palette translation values, one per possible pixel value 
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STSC APL*Plus/PC 


APL is a mathematically-oriented programming language well-suited to manipulating vectors and matrices. In its 
original incarnation, it used the Greek alphabet and numerous special symbols as commands and operators. Such use 
of special symbols leads to compact but difficult-to-read code, and resulted in APL’s reputation as a “write-only" lan- 


guage. 


STSC, Inc. has been the major vendor of APL products on the IBM PC family, and has produced a number of in- 
terpreters over the years, Some include special display fonts to provide the original symbol set, while others allow the 
use of keywords rather than symbols, In addition to interpreters, STSC provides such varied products based on APL 


as programming tools and a spreadsheet manager for interfacing with Lotus 1-2-3. 


INTERRUPT 86h 
TERMINATE APL SESSION AND RETURN TO DOS 


Purpose: Exit the APL interpreter. 
Available on: All machines. 


Registers at call: n/a Return Registers: n/a 
Conflicts: Basic interpreter (chapter 1), Relocated (by NETBIOS) INT 18 (chapter 27). 
INTERRUPT 87h 

Unknown Function 


Purpose: unknown. 
Available on: All machines. 
Registers at call: unknown Return Registers: unknown. 
Conflicts: BASIC interpreter (chapter 1). 


INTERRUPT 88h - Function 00h 
CREATE OBJECT OF ARBITRARY RANK OR SHAPE 
Purpose: Assign a new variable of the specified type and dimensions. 
Available on: All machines. 
Registers at call: Return Registers: 
AL = 00h ES:DI - > first data byte of object 
BX = STPTR of the variable to be assigned DX:CX = number of elements in the object 
ES:SI - > model of type, rank, and shape (Table 
31-1) 
Conflicts: BASIC interpreter (chapter 1). 
See Also: INT C8h 


Table 31-1. Format of Shape Model: 


Offset Size Description 


00h BYTE type: Oth character (2-byte dimension sizes) 
02h integer (2-byte dimension sizes) 
08h floating point (2-byte dimension sizes) 
11h character (4-byte dimension sizes) 


Restrictions: APL*Plus/PC must be running. 


Restrictions: APL*Plus/PC must be running. 


Restrictions: APL*Plus/PC must be running. 
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Table 31-1. Format of Shape Model (continued) 


Offset Size Description 
12h integer (4-byte dimension sizes) 
18h floating point (4-byte dimension sizes) 


Oth BYTE rank 
02h (note) first dimension of shape 
N (note) second dimension of shape 


Note: May be WORD/DWORD as indicated by "type" value. 


INTERRUPT 88h - Function 01h 
CREATE CHARACTER SCALAR/VECTOR/MATRIX <64K IN SIZE 


Purpose: Reserve storage for a character or a one- or two-dimensional array of characters. 


Available on: All machines. Restrictions: APL*Plus/PC must be running. 
Registers at call: Return Registers: 

AL =0th ES:DI -> object 

AH = rank CX = number of elements in the object 


BX = STPTR of the variable to be assigned 

CX = first dimension (if any) 

DX = second dimension (if any) 

Details: Each dimension must be 32767 or smaller. 
Conflicts: BASIC interpreter (chapter 1). 

See Also: Functions 02h and O8h,INT C8h 


INTERRUPT 88h - Function 02h 
CREATE INTEGER SCALAR/VECTOR/MATRIX <64K IN SIZE 


Purpose: Reserve storage for an integer or a one- or two-dimensional array of integers. 


Available on: All machines. Restrictions: APL*Plus/PC must be running. 
Registers at call: Return Registers: 

AL = 02h ES:DI -> object 

AH = rank CX = number of elements in the object 


BX = STPTR of the variable to be assigned 

CX = first dimension (if any) 

DX = second dimension (if any) 

Details: Each dimension must be 32767 or smaller. 
Conflicts: BASIC interpreter (chapter 1). 

See Also: Functions 01h and 08h, INT C8h 


INTERRUPT 88h - Function 08h 
CREATE FLOATING POINT SCALAR/VECTOR/MATRIX <64K IN SIZE 


Purpose: Reserve storage for a floating point number or a one- or two-dimensional array of floating point numbers, 


Available on: All machines. Restrictions: APL*Plus/PC must be running. 
Registers at call: Return Registers: 

AL = 08h ES:DI -> object 

AH = rank CX = number of elements in the object 


BX = STPTR of the variable to be assigned 

CX = first dimension (if any) 

DX = second dimension (if any) 

Details: Each dimension must be 32767 or smaller. 
Conflicts: BASIC interpreter (chapter 1). 

See Also: Functions 01h and 02h, INT C8h 
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INTERRUPT 88h - Function F5h 
FORCE OBJECT INTO REAL WORKSPACE FROM VIRTUAL 


Purpose: Copy the specified object into main memory if it is not currently there. 


Available on: All machines. Restrictions: APL*Plus/PC must be running. 
Registers at call: Return Registers: n/a 
AL = F5h 


BX = STPTR of object 
Conflicts: BASIC interpreter (chapter 1). 
See Also: INT C8h 


INTERRUPT 88h - Function F6h 
MAKE NAME IMMUNE FROM OUTSWAPPING 


Purpose: Specify that the indicated object must remain in main memory. 


Available on: All machines. Restrictions: APL"Plus/PC must be running. 
Registers at call: Return Registers: n/a 
AL = F6h 


BX = STPTR of object 
Conflicts: BASIC interpreter (chapter [). 
See Also: Functions F7h and F8h, INT C8h 


INTERRUPT 88h - Function F7h 
MAKE NAME ELIGIBLE FOR OUTSWAPPING 


Purpose: Specify that the indicated object may be moved out of main memory if memory becomes scarce. 


Available on: All machines. Restrictions: APL*Plus/PC must be running. 
Registers at call: Return Registers: n/a 
AL=F7h 


BX = STPTR of object 
Conflicts: BASIC interpreter (chapter 1). 
See Also: Functions F6h and F8h, INT C8h 


INTERRUPT 88h - Function F8h 
REPORT WHETHER NAME 1S ELIGIBLE FOR OUTSWAPPING 


Purpose: Determine whether the indicated object may be moved out of main memory. 


Available on: All machines. Restrictions: APL*Plus/PC must be running. 
Registers at call: Return Registers: 

AL = F8h BX = 0000h eligible 

BX = STPTR of object 0001h not eligible 


Conflicts: BASIC interpreter (chapter 1). 
See Also: Functions Féh and F7h, INT C8h 


INTERRUPT 88h - Function F9h 


DETERMINE NAME STATUS 

Purpose: Determine whether the indicated object name is available for use. 

Ayailable on: All machines. Restrictions: APL*Plus/PC must be running. 

Registers at call: Return Registers: 

AL=F9h CF set if name ill-formed or already in use 
BX = STPTR if already in symbol table 

ES:SI -> name CF clear if name is available for use 

CX = length of name BX = 0000h 


Details: Does not force the name into the workspace. 
Conflicts: BASIC interpreter (chapter 1). 
See Also: Functions FEh and FFh, INT C8h 
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INTERRUPT 88h - Function FCh 
DETERMINE IF MEMORY AVAIL WITHOUT GARBAGE COLLECTION 


Purpose: Determine whether there is currently a block of free memory large enough to hold the specified memory 


request. 

Available on: All machines. Restrictions: APL*Plus/PC must be running. 
Registers at call: Return Registers: 

AL=FCh CF clear if memory available 

BX = amount of memory needed (paragraphs) CF set if a workspace compaction is required 


Conflicts: BASIC interpreter (chapter 1). 
See Also: Function FDh, INT C8h 


INTERRUPT 88h - Function FDh 
PERFORM GARBAGE COLLECTION AND RETURN AVAILABLE MEMORY 


Purpose: Determine the free space after compacting all allocated memory in the workspace. 


Available on: All machines. Restrictions: APL*Plus/PC must be running. 
Registers at call: Return Registers: 
AL=FDh BX = number of paragraphs available in workspace 


Conflicts: BASIC interpreter (chapter 1). 
See Also: Function FCh, INT C8h 


INTERRUPT 88h - Function FEh 
CREATE NAME 


Purpose: Store the specified name which will later be associated with an object. 





Available on: All machines. Restrictions: APL*Plus/PC must be running. 


Registers at call: 
AL = FEh 

ES:SI -> name 

CX = length of name 


Return Registers: 
BX = STPTR of name 
DX = interpreter's data segment 


Conflicts: BASIC interpreter (chapter 1). 


See Also: Functions F9 


Ih and FFh, INT C8h 


INTERRUPT 88h - Function FFh 


DETERMINE NAME STA 


TUS 


Purpose: Determine whether the specified name is available for use, and create it if it did not already exist. 
Available on: All machines. Restrictions: APL*Plus/PC must be running. 


Registers at call: 
AL = FFh 

ES:SI -> name 

CX = length of name 


Return Registers: 
CF set if name ill-formed or already in use 
BX = STPTR if already in symbol table 
CF clear if name is available for use 
BX =0000h 


Details: Forces the name into the workspace and makes it immune from outswapping. 
Conflicts: BASIC interpreter (chapter 1). 


See Also: Functions F9 


INTERRUPT 8Ah 
PRINT SCREEN 


h and FEh, INT C8h 


Purpose: Dump the current contents of the screen to the printer. 
Available on: All machines. Restrictions: APL*Plus/PC must be running. 


Details: This call is the 


same as INT 05h. 


Conflicts: BASIC interpreter (chapter 1). 
See Also: INT 05h (chapter 3), INT CAh 
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INTERRUPT 8Bh 

BEEP 

Purpose: Sound a beep. 

Available on; All machines, Restrictions: APL*Plus/PC must be running. 
Registers at call: n/a Return Registers: n/a 


Details: This call is the same as printing a “G via INT 21h Function 02h, 
Conflicts: BASIC interpreter (chapter 1). 
See Also: INT CBh, DOS INT 21h Function 02h (chapter 8) 


INTERRUPT 8Ch 
CLEAR SCREEN MEMORY 


Purpose: Erase the display to blanks. 
Available on: All machines. F Restrictions: APL*Plus/PC must be running. 
Registers at call: Return Registers: n/a 
AX = flag 
0000h do not save display attributes 
0001h save attributes 
Conflicts: BASIC interpreter (chapter 1). 
See Also: INT CCh 


INTERRUPT 90h 
USED BY PORT 10 PRINTER DRIVER 


Purpose: unknown, 


Available on: All machines. Restrictions; APL*Plus/PC must be running, 
Registers at call: unknown, Return Registers: unknown. 

Conflicts: BASIC interpreter (chapter 1). 

INTERRUPT 95h 

DETERMINE R= SPACE 

Purpose: unknown. 

Available on: All machines. Restrictions: APL*Plus/PC must be running, 
Registers at call: unknown. Return Registers: unknown. 


Details: Use only when the R= option is invoked on entering APL. 
Conflicts: BASIC interpreter (chapter 1). 


INTERRUPT A0h 

USED BY APL/GSS*CGI GRAPHICS INTERFACE 

Purpose: Support the display of graphics, 

Available on: All machines, Restrictions: APL*Plus/PC must be running. 
Registers at call: unknown. Return Registers: unknown. 

Conflicts: BASIC interpreter (chapter 1). 

See Also: INT 59h (chapter 5) 


INTERRUPT C6h through INT CCh 

IDENTICAL TO INT 86h through INT 8Ch 

Purpose: STSC moved its interrupts from 86h-8Ch to C6h-CCh, but did not delete the older interrupts. 
Available on: All machines. Restrictions: APL*Plus/PC must be running. 
Registers at call: unknown. Return Registers: unknown. 

Conflicts: BASIC interpreter (chapter 1). 
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INTERRUPTS CDh and CEh 
MAY BE USED IN FUTURE RELEASES 


Purpose: STSC has indicated that it may use these interrupts in future releases of APL*Plus/PC. 


Available on: All machines. Restrictions: APL*Plus/PC must be running. 
Registers at call: unknown. Return Registers: unknown. 

Conflicts: BASIC interpreter (chapter 1). 

INTERRUPT CFh 


DEFAULT LOW-RESOLUTION TIMER FOR QUAD MF FUNCTION 


Purpose: Time function execution. 


Available on: All machines, Restrictions: APL*Plus/PC must be running. 


Registers at call: unknown. Return Registers: unknown. 
Conflicts: BASIC interpreter (chapter 1). 


INTERRUPTS DOh through DBh 
MAY BE USED IN FUTURE RELEASES 


Purpose: STSC has indicated that it may use these interrupts in future releases of APL*Plus/PC, 


Available on: All machines. Restrictions: APL*Plus/PC must be running. 


Conflicts: BASIC interpreter (chapter 1), PC-MOS API on INT D4h (chapter 1). 


INTERRUPT DCh 
MAY BE USED IN FUTURE RELEASES 


Purpose: STSC has indicated that it may use this interrupt in future releases of APL*Plus/PC. 


Available on: All machines. Restrictions: APL*Plus/PC must be running. 
Registers at call: unknown. Return Registers: unknown. 

Conflicts: BASIC interpreter (chapter 1), PC/370 v4.1- - API (chapter 36). 

INTERRUPT DDh 


MAY BE USED IN FUTURE RELEASES 
Purpose: STSC has indicated that it may use this interrupt in future releases of APL*Plus/PC. 


Available on: All machines. Restrictions: APL*Plus/PC must be running. 
Registers at call: unknown. Return Registers: unknown. 

Conflicts: BASIC interpreter (chapter 1). 

INTERRUPT DEh 

Unknown Function 

Purpose: This interrupt appears to be the same as INT 16h. 

Available on: All machines. Restrictions: APL*Plus/PC must be running, 
Registers at call: unknown. Return Registers: unknown. 

Conflicts: BASIC interpreter (chapter 1). 

INTERRUPT DFh 

SAME AS INT 10h 

Purpose: Alternate entry point for video services. 

Available on: All machines. Restrictions: APL*Pius/PC must be running. 
Registers at call: Return Registers: 

see INT 10h in chapter 5. see INT 10h in chapter 5. 


Conflicts: BASIC interpreter (chapter 1), Victor 9000 - SuperBIOS (chapter 4). 
See Also: INT 10h 
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STSC APL*Plus/PC 
INTERRUPT E0h 
RESTIME HIGH-RESOLUTION TIMER FOR QUAD MF FUNCTION 
Purpose: Time function execution. 
Available on: All machines. Restrictions: APL*Plus/PC must be running. 
Registers at call: unknown. Return Registers: unknown. 


Conflicts: CP/M-86 function calls, BASIC interpreter (chapter 1), "Micro-128" virus (chapter 34). 
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Chapter @ a 


ZIPKEY 





ZIPKEY is a shareware resident ZIP code and area code database by Eric Isaacson. 


INTERRUPT B3h - Function 70h 


GET VERSION 

Purpose: Determine whether ZIPKEY is present and if so, get its version. 
Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AH =70h AH = major version 


AL = minor version 
CL = number of states and territories in the current 
database 

DH = year of current database - 1900 

DL = month of current database’s file date 
Details; If installed, the string "ZIPKEY" is present at offset 75h in the interrupt handler’s segment, and the byte at 
7Bh contains the API version number (00h for versions 1.x and 01h for version 2.0). 
Conflicts: BASIC interpreter (chapter 1). 


INTERRUPT B3h - Function 71h 
CONVERT TWO-LETTER ABBREVIATION TO STATE CODE 


Purpose: Determine the internal code number corresponding to the postal state code. 


Available on: All machines. Restrictions: ZIPKEY must be installed. 
Registers at call: Return Registers: 
AH = 71h CF set on error 
BX = abbreviation, in upper or lower case; BL is the AL = FFh 
first letter CF clear if successful 


AL =ZIPKEY state code 
Conflicts: BASIC interpreter (chapter 1), 
See Also: Function 72h 


INTERRUPT B3h - Function 72h 
CONVERT STATE CODE TO TWO-LETTER ABBREVIATION 


Purpose: Determine the postal state code corresponding to the specified ZIPKEY internal code number. 


Available on: All machines, Restrictions: ZIPKEY must be installed. 
Registers at call: Return Registers: 
AH =72h CF clear if successful 
BL = ZIPKEY state code AX = abbreviation, in upper case; AL is the first 
letter 
CF set on error 
AX destroyed 


Conflicts: BASIC interpreter (chapter 1). 
See Also: Functions 71h and 73h 
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INTERRUPT B3h - Function 73h 
CONVERT STATE CODE TO STATE NAME 


Purpose: Determine the name of the state for the indicated ZIPKEY internal code number. 


Available on: All machines. Restrictions; ZIPKEY must be installed. 
Registers at call: Return Registers: 

AH = 73h AX destroyed 

BL =ZIPKEY state code CF clear if successful 

ES:DI -> buffer for name ES:DI points one byte beyond end of name 


CF set on error 
Conflicts: BASIC interpreter (chapter 1). 
See Also: Function 72h 


INTERRUPT B3h - Function 74h 
CONVERT ZIPCODE TO ASCII DIGITS 


Purpose: Generate a printable ZIP code into a user-specified buffer. 


Available on: All machines. Restrictions: ZIPKEY must be installed. 

Registers at call: Return Registers: 

AH = 74h AX destroyed 

DX = zipcode region (0-999) CF clear if successful 

CH = last two digits of zipcode (0-99) ES:DI points one byte beyond end of digit string 
ES:DI -> buffer CF set on error 


Conflicts: BASIC interpreter (chapter 1). 


INTERRUPT B3h - Function 75h 
LOOK UP STATE CODE FOR ZIPCODE 


Purpose: Determine in which state the specified ZIP code is located. 


Available on: All machines. Restrictions: ZIPKEY must be installed. 
Registers at call: Return Registers: 

AH = 75h CF clear if successful 

DX = zipcode region (0-999) AL = ZIPKEY state code 

CH = last two digits of zipcode (0-99) BX = (version 2.0-+) telephone area code 


CF set on error (zipcode not found) 
AL = suggested state code, FFh if none 
Details: This function does not check whether the individual ZIP code actually exists, only the region. The validity 
of a ZIP code may be checked with Function 76h. 
Conflicts: BASIC interpreter (chapter 1). 
See Also: Functions 76h and 79h 


INTERRUPT B3h - Function 76h 
LOOK UP CITY AND STATE FOR ZIPCODE 


Purpose: Determine the exact location of the indicated ZIP code. 


Available on: All machines. Restrictions: ZIPKEY must be installed. 
Registers at call: Return Registers: 

AH = 76h CF clear if successful 

DX = zipcode region (0-999) AL = ZIPKEY state code 

CH = last two digits of zipcode (0-99) BX = (version 2,0+) telephone area code 
ES:DI -> buffer for name ES:DI points one byte beyond end of the name 


CF set on error 
AL = suggested state code, FFh if none 
ES:DI buffer filled with suggested city name 
Conflicts: BASIC interpreter (chapter 1). 
See Also: Functions 75h and 78h 
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INTERRUPT B3h - Function 77h 
PLAY BACK EXIT KEY FOR ENTRY WITH GIVEN ZIPCODE 


Purpose: Trigger stuffing of the keyboard buffer with a found entry as if the user had requested the action. 


Available on: All machines. Restrictions: ZIPKEY must be installed. 

Registers at call: Return Registers: 

AH=77h AX destroyed 

DX = zipcode region (0-999) CF clear if successful 

CH = last two digits of zipcode (0-99) zipcode specification as defined by the BX 

BX = 16-bit BIOS keycode for a defined ZIPKEY keystroke is placed in keyboard buffer, as if the 
alternate exit key user had popped up ZIPKEY and exited by 


pressing the key specified by BX 
CF set on error 
Conflicts: BASIC interpreter (chapter 1). 


INTERRUPT B3h - Function 78h 
LOOK UP ZIPCODES FOR A GIVEN STATE AND CITY 


Purpose: Determine the ZIP codes located in a specific city. 


Available on: All machines. Restrictions: ZIPKEY must be installed. 
Registers at call: Return Registers: 
AH = 78h AX destroyed 
BL = ZIPKEY state code BH = number of matching entries (set to 51 if more 
DS:SI -> city name, terminated with ODh if than 50) 

complete name, 00h if prefix DX = zipcode region of first match (0-999) 


CL = last two digits of first zipcode in the range (0-99) 
CH = last two digits of last zipcode in the range (0-99) 


Conflicts: BASIC interpreter (chapter 1). 
See Also: Functions 79h and 7Ah 


INTERRUPT B3h - Function 79h 
LOOK UP ZIPCODES FOR A GIVEN CITY 


Purpose: Determine the states for all cities with the given name, and the ZIP codes located in those cities. 


Available on: All machines. Restrictions: ZIPKEY must be installed. 
Registers at call: Return Registers: 
AH=79h AL = ZIPKEY state code of first matching state 
BL = ZIPKEY state code of first state to search BH = number of matching entries (set to 51 if more 
DS:SI -> city name, terminated with ODh if than 50) 
complete name, 00h if prefix DX = zipcode region of first match (0-999) 
CL = last two digits of first zipcode in first range 
(0-99) 
CH = last two digits of last zipcode in first range 
(0-99) 


Details: To find all matching cities, repeat search with BL set to one more than the returned AL. 
Conflicts: BASIC interpreter (chapter 1). 
See Also: Functions 78h and 7Ah 


INTERRUPT B3h - Function 7Ah 


FETCH AN ENTRY FROM A PREVIOUS LOOKUP 


Purpose: Retrieve one of the matches from the last search. 
Available on: All machines. Restrictions: ZIPKEY must be installed. 
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Registers at call: 

AH =7Ah 

BL = case number (0 to one less than value returned 
in BH by lookup) 


Conflicts: BASIC interpreter (chapter 1). 
See Also: Functions 78h and 79h 


INTERRUPT B3h - Function 7Bh 
GET VALUES NEEDED TO SAVE ZIPKEY CONTEXT 


Return Registers: 

AL = ZIPKEY state code 

DX = zipcode region (0-999) 

CL = last two digits of first zipcode in the range (0-99) 
CH = last two digits of last zipcode in the range (0-99) 


Purpose: Determine the current state of a search for later restoration. 


Available on: All machines, 
Registers at call: 
AH =7Bh 


Conflicts: BASIC interpreter (chapter 1), 
See Also: Function 7Ch 


INTERRUPT B3h - Function 7Ch 
RESTORE ZIPKEY CONTEXT 


Purpose: Reset searching to a previous state. 

Available on: All machines. 

Registers at call: 

AH=7Ch 

BL = maximum number of characters for a city 

name 

BH = ZIPKEY state code for last city-name search 
FFh if none 

CX:DX = internal code returned by Function 7Bh 

Conflicts: BASIC interpreter (chapter 1), 

See Also: Function 7Bh 


INTERRUPT B3h - Function 7Dh 
REQUEST POP UP 


Restrictions: ZIPKEY must be installed, 

Return Registers: 

AX destroyed 

BL = maximum number of characters for a city name 

BH = ZIPKEY state code for last city-name search 
FFh if none 

CX:DX = internal code identifying last city search 


Restrictions: ZIPKEY must be installed. 
Return Registers: 

AX destroyed 

CF clear if successful 

CF set on error 


Purpose: Trigger the TSR pop-up sequence as though the user had pressed the hotkey. 


Available on: All machines. 
Registers at call: 
AH =7Dh 
BL = index number to simulate pressing a hotkey 
FFh for immediate popup with no playback on 
return 


Conflicts: BASIC interpreter (chapter 1). 
INTERRUPT B3h - Function 7Eh 
GET NAME OF PRIMARY CITY FOR A ZIPCODE REGION 


Purpose: Translate ZIP code to primary city name. 
Available on: All machines. 


Restrictions: ZIPKEY must be installed. 
Return Registers: 
CF clear if successful 
AX destroyed 
window popped up and was closed by the user 
CF set on error 
AL = FDh already busy with another request 
=: FEh illegal function 


Restrictions: ZIPKEY must be installed. 





H 
i 
i 





Registers at call: 

AH = 7Eh 

DX = zipcode region (0-999) 
ES:DI -> buffer for name 


Conflicts: BASIC interpreter (chapter 1). 


INTERRUPT B3h - Function 7Fh 
ENABLE/DISABLE HOTKEYS 


Purpose: Control hotkey actions. 
Available on: All machines. 
Registers at call: 
AH = 7Fh 
BL = function 
00h turn off hotkeys 
O1h turn on hotkeys 
02h return hotkey status 
03h toggle hotkey status 
Conflicts: BASIC interpreter (chapter 1). 


INTERRUPT B3h - Function 80h 
DETERMINE STATE FOR AREA CODE 
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Return Registers: 
CF clear if successful 
AL = ZIPKEY state code 
BX = (version 2.0+) telephone area code 
ES:DI points one byte beyond end of the name 
CF set on error 
AL = FFh region does not exist 


Restrictions; ZIPKEY must be installed. 
Return Registers: 
AL = hotkey status 

00h off 

Olh on 


Purpose: Given a telephone area code, determine which state contains that area code and the range of ZIP codes for 


the state. 
Available on: All machines. 


Registers at call: 


AH = 80h 
BX = telephone area code (decimal) 


Conflicts: BASIC interpreter (chapter 1). 


Restrictions: ZIPKEY version 2.0 or higher must be 
installed, 
Return Registers: 
CF clear if successful 
AL = ZIPKEY state code 
DX = first zip region for state, O3E8h (1000) if 
Canada 
CX = number of zip regions in state 
CF set if error (no such area code) 
AL =FFh 
DX = 03E9h (1001) 
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Chapter 43 


PC Tools 


PC Tools by Central Point Software has been described as the "Swiss Army knife of software." While many software 
packages perform individual functions more quickly or more efficiently, few contain the sheer functionality of PC 
Tools. In addition to a DOS shell; desktop utilities such as calculators, notepads, data base retrieval, appointment cal- 
endar, and communications; hard disk backup; and data recovery utilities, PC Tools contains numerous other pro- 
grams, 

PC Tools version 7 was released as this book was written, Thus, the version 7 information presented here is quite 
preliminary and even sketchier than the remainder of the API (which is entirely undocumented). Calls which do not 
explicitly mention version 7 may have changed between versions 6 and 7; further, many of the calls marked "version. 
5.1 or higher" may have been present in earlier versions, although we do not have any information on versions prior 
to 5.1. 


INTERRUPT 16h - Function 6969h, Subfunction 6968h 





UNHOOK BACKTALK 

Purpose: Restore the interrupt vectors which were hooked by BACKTALK in preparation for unloading. 

Available on: All machines. Restrictions: PC Tools version 5.1 or higher 
BACKTALK must be installed. 

Registers at call: Return Registers: 

AX = 6969h resident code unhooked, but not removed from 

BX = 6968h memory 


Conflicts: None known. 


INTERRUPT 16h - Function 6969h, Subfunction 6969h 
BACKTALK INSTALLATION CHECK 


Purpose: Determine whether PC Tools version 5.1 or higher BACKTALK is installed. 


Available on: All machines. Restrictions: none. 

Registers at call: Return Registers: 

AX = 6969h DX nonzero if installed 

BX = 6969h BX = CS of resident code 

DX = 0000h DX = PSP segment of resident code 


DS:SI - > ASCIZ identification string "CPoint Talk” 
Conflicts: None known. 


INTERRUPT 16h - Function FEh, Subfunction A4h 


Unknown Function 
Purpose: The purpose of this function had not been determined at the time of writing. 
Available on: All machines. Restrictions: PC Tools version 7.0 CPSCHED or 


DESKTOP must be installed. 
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Registers at call: Return Registers: unknown. 
AX = FEA4h 

other unknown. 

Conflicts: None known. 


INTERRUPT 16h - Function FEh, Subfunction C6h 


Unknown Function 

Purpose: The purpose of this function had not been determined at the time of writing. 

Available on: All machines. Restrictions: PC Tools version 7.0 CPSCHED must 
be installed. 

Registers at call: Return Registers: unknown. 

AX = FEC6h 

DL = unknown, 

Conflicts: None known. 

INTERRUPT 16h - Function FEh, Subfunction D3h 

Unknown Function 

Purpose: The purpose of this function had not been determined at the time of writing. 

Available on: All machines, Restrictions: PC Tools version 7,0 CPSCHED or 
DESKTOP must be installed. 

Registers at call: Return Registers: unknown. 

AX = FED3h 

other unknown. 

Conflicts: None known, 

INTERRUPT 16h - Function FEh, Subfunction DCh 

Unknown Function 

Purpose: The purpose of this function had not been determined at the time of writing. 

Available on: All machines. Restrictions: PC Tools version 7.0 CPSCHED must 
be installed. 

Registers at call: Return Registers: unknown, 

AX =FEDCh 

other unknown. 

Conflicts: None known. 

INTERRUPT 16h - Function FEh, Subfunction EFh 

INSTALLATION CHECK 

Purpose: Determine whether the PC Tools scheduler is installed. 

Available on: All machines. Restrictions: PC Tools version 7.0 CPSCHED or 
DESKTOP must be installed. 

Registers at call: Return Registers: 

AX = FEEFh CX = ABCDh if PC Tools scheduler is installed 

CX = 0000h BX = segment of resident portion 


Details: This call is identical to Function FFh Subfunction EFh for DESKTOP. 
Conflicts: None known. 


INTERRUPT 16h - Function FEh, Subfunction Fih 


Unknown Function 
Purpose: The purpose of this function had not been determined at the time of writing. 
Available on: All machines. Restrictions: PC Tools version 7.0 CPSCHED or 


DESKTOP must be installed. 


PC Tools 33-3 


Registers at call: Return Registers: unknown. 


AX = FEFIh 
other unknown. 
Conflicts: None known. 


INTERRUPT 16h - Function FFh, Subfunctions 91h to 99h 


Unknown Functions 

Purpose: The purpose of these functions had not been determined at the time of writing. 

Available on: All machines. Restrictions: PC Tools version 7.0 DESKTOP must 
be installed. 

Registers at call: Return Registers: unknown. 

AX = FF91h to FF9Bh 

other unknown. 

Conflicts: None known, 

INTERRUPT 16h - Function FFh, Subfunction 9Ah 

GET COLOR SCHEME 

Purpose: Retrieve the name of the color scheme currently in use. 

Available on: All machines, Restrictions: PC Tools version 7.0 DESKTOP must 
be installed. 

Registers at call: Return Registers: 

AX = FF9Ah ES:BX -> ASCIZ name of current color scheme 

Conflicts: None known. 

INTERRUPT 16h - Function FFh, Subfunction 9Eh 

Unknown Function 

Purpose: The purpose of this function had not been determined at the time of writing. 

Available on: All machines. Restrictions: PC Tools version 7.0 DESKTOP must 
be installed. 

Registers at call: Return Registers: unknown. 

AX = FF9Eh 

other unknown. 

Conflicts: None known. 

INTERRUPT 16h - Function FFh, Subfunction Aih 

Unknown Function 

Purpose: The purpose of this function had not been determined at the time of writing. 

Available on: All machines. Restrictions: PC Tools version 7.0 DESKTOP must 
be installed. 

Registers at call: Return Registers: unknown, 

AX =FFAIh 

other unknown, 

Conflicts: None known. 

INTERRUPT 16h - Function FFh, Subfunction A2h 

Unknown Function 

Purpose: The purpose of this function had not been determined at the time of writing. 

Available on: All machines. Restrictions: PC Tools version 7.0 DESKTOP must 
be installed. 

Registers at call: Return Registers: unknown. 

AX = FFA2h 


other unknown. 
Conflicts: None known. 
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INTERRUPT 16h - Function FFh, Subfunction A3h 


DATAMON 

Purpose: Control the operation of the DATAMON file protection program. 

Available on: All machines. Restrictions: PC Tools version 7.0 DATAMON must 
be installed. 

Registers at call: Return Registers: 

AX = FFA3h 


BX = CX = function 

0000h installation check 
AX = resident code segment 
BX = 5555h 
CX = 5555h 

O0001h unknown 
AX:BX -> unknown. 
CX =BX 

0002h unknown 
AX = unknown (0000h or 0001h) 


CX =BX = AX 
0003h unknown 
AX = unknown (0000h or 0001h) 
CX =BX =AX 
0004h set unknown flag 
n/a 
0005h clear unknown flag 
nfa 
0006h set current PSP 
DX = current PSP as known to DOS, or 0000h n/a 
Conflicts: None known. 
INTERRUPT 16h - Function FFh, Subfunction A4h 
Unknown Function 
Purpose: The purpose of this function had not been determined at the time of writing. 
Available on: All machines. Restrictions: PC Tools version 7.0 DESKTOP must 
be installed. 
Registers at call: Return Registers: unknown. 
AX = FFA4h 
other wiknown. 
Conflicts: None known. 
INTERRUPT 16h - Function FFh, Subfunction A5h 
PC-Cache 
This function is described in chapter 6. 
INTERRUPT 16h - Function FFh, Subfunction A6h 
GET Unknown Pointer 
Purpose: unknown. 
Available on: All machines. Restrictions: PC Tools version 6.0 or higher 
DESKTOP must be installed. 
Registers at call: Return Registers: 
AX = FFA6h DS:SI -> unknown code or data. 


Conflicts: None known. 
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INTERRUPT 16h - Function FFh, Subfunction A7h 


GET Unknown PATH 

Purpose: Apparently returns the location of the desktop’s executable. 

Available on: All machines. Restrictions: PC Tools version 6.0 or higher 
DESKTOP must be installed. 

Registers at call: Return Registers: 

AX = FFAT7h DS:SI -> ASCIZ path (directory from which PCTools 

was run) 

Conflicts: None known. 

INTERRUPT 16h - Function FFh, Subfunction A8h 

Unknown Function 

Purpose: unknown, 

Available on: All machines. Restrictions: PC Tools version 6.0 or higher 
DESKTOP must be installed. 

Registers at call: Return Registers: unknown. 

AX = FFA8h 


DS:SI -> three consecutive unknown 
ASCIZ strings (max 256 bytes 
total) 
other unknown. 
Details; This function is only available when popped up. The specified strings are copied into internal buffer, among 
other actions. 
Conflicts: None known. 


INTERRUPT 16h - Function FFh, Subfunction A9h 


GET VERSION STRING 

Purpose: Retrieve a printable string identifying the version of PC Tools DESKTOP installed. 

Available on: All machines. Restrictions: PC Tools version 6.0 or higher 
DESKTOP must be installed. 

Registers at call: Return Registers: 

AX = FFA9h DS:SI -> version string 

Conflicts: None known. 

INTERRUPT 16h - Function FFh, Subfunction AAh 

Unknown Function 

Purpose: unknown. 

Available on: All machines. Restrictions; PC Tools version 6.0 or higher 
DESKTOP must be installed. 

Registers at call: Return Registers: unknown. 

AX = FFAAh 

unknown. 

Details: This function is only available when popped up. 

Conflicts: None known, 

INTERRUPT 16h - Function FFh, Subfunction ABh 

GET EDITOR SETTINGS 

Purpose: Determine the settings used by the desktop's editor. 

Available on: All machines. Restrictions: PC Tools version 6.0 or higher 
DESKTOP must be installed. 

Registers at call: Return Registers: 


AX = FFABh DS:SI -> editor setting strings 
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Conflicts: None known, 


INTERRUPT 16h - Function FFh, Subfunction ACh 
SET Unknown Value 


Purpose: unknown. 
Available on: All machines. 


Registers at call: 

AX = FFACh 

DL = unknown, 

Details: This function is only available when popped up. 
Conflicts: None known. 


INTERRUPT 16h - Function FFh, Subfunction ADh 
SET Unknown Value 


Purpose: unknown. 
Available on: All machines, 


Registers at call: 

AX = FFADh 

DL = unknown. 
Conflicts: None known, 


INTERRUPT 16h - Function FFh, Subfunction AEh 
GET Unknown Value 


Purpose: Determine the value of an unknown flag or counter, 
Available on: All machines. 


Registers at call: 
AX = FFAEh 
Conflicts: None known. 


INTERRUPT 16h - Function FFh, Subfunction AFh 
SET Unknown Value 


Purpose: unknown. 
Available on; All machines, 


Registers at call: 

AX = FFAFh 

DL = unknown. 
Conflicts: None known. 


INTERRUPT 16h - Function FFh, Subfunction BOh 
SET Unknown Value 

Purpose: unknown. 

Available on: All machines. 


Registers at call: 

AX = FFBOh 

BL = unknown. 
Conflicts: None known, 


Restrictions: PC Tools version 6.0 or higher 
DESKTOP must be installed. 
Return Registers: n/a 


Restrictions: PC Tools version 6.0 or higher 
DESKTOP must be installed. 
Return Registers: n/a 


Restrictions: PC Tools version 6.0 or higher 
DESKTOP must be installed. 

Return Registers: 

AL = unknown. 


Restrictions: PC Tools version 6.0 or higher 
DESKTOP must be installed. 
Return Registers: n/a 


Restrictions: PC Tools version 6.0 or higher 
DESKTOP must be installed. 
Return Registers: n/a 


INTERRUPT 16h - Function FFh, Subfunction B1h 
Unknown Function 

Purpose: unknown. 

Available on: All machines. 


Registers at call: 

AX = FFBIh 

unknown. 

Conflicts: None known. 


INTERRUPT 16h - Function FFh, Subfunction B2h 
GET Unknown Pointer 

Purpose: unknown, 

Available on: All machines. 


Registers at call: 
AX = FFB2h 
Conflicts: None known. 


INTERRUPT 16h - Function FFh, Subfunction B3h 
Unknown Function 

Purpose: unknown. 

Available on: All machines. 


Registers at call: 

AX = FFB3h 

unknown, 

Details: This function is only available when popped up. 
Conflicts: None known. 


INTERRUPT 16h - Function FFh, Subfunction B4h 
SET Unknown FLAG 


Purpose: unknown. 
Available on: All machines. 


Registers at call: 

AX = FFB4h 

Details: This function is available only when popped up. 
Conflicts: None known. 

See Also: Function FFh Subfunction BBh 


INTERRUPT 16h - Function FFh, Subfunction BSh 
GET/SET WINDOW PARAMETERS 
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Restrictions; PC Tools version 6.0 or higher 
DESKTOP must be installed. 
Return Registers: unknown. 


Restrictions: PC ‘Tools version 5.5 or higher 
DESKTOP must be installed. 

Return Registers: 

DS:SI -> unknown. 


Restrictions: PC Tools version 5.5 or higher 
DESKTOP must be installed. 
Return Registers: unknown. 


Restrictions: PC Tools version 5.5 or higher 
DESKTOP must be installed. 
Return Registers: n/a 


Purpose: Determine or specify the window parameters for the indicated desktop application. 


Available on: All machines. 


Registers at call: 

AX = FFBSh 

BX = window specifier (QOOFh to 0019h) 
(Table 33-1) 

DX = 0000h get, nonzero = set 

ES:DI -> window parameter buffer (Table 33-2) 


Restrictions; PC Tools version 5.5 or higher 


DESKTOP must be installed. 
Return Registers: n/a 
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Details: If running in monochrome mode, character attributes at offsets 04h to 06h are stored unchanged, but 
attributes other than 07h, OFh, or 70h are changed to 07h on reading. 

Conflicts: None known. 

See Also: Function FFh Subfunction CBh 


Table 33-1. Values for Window Specifier: 


Value Meaning 

O00Fh commlFAX 

O014h hotkey selection 
O015h ASCII table 

0016h system colors menu 


Table 33-2. Format of Window Parameters: 


Offset Size Description 

00h BYTE rows in window, not counting frame 
Oth BYTE columns in window, not counting frame 
02h BYTE tow number of top of window 

03h BYTE 2*column number of left of window 
04h BYTE character attribute for unknown text 

05h BYTE character attribute for background/border 
06h BYTE character attribute for unknown text 
O7h DWORD __ pointer to unknown location on screen 
OBh 4BYTEs — unknown. 

OFh BYTE nonzero if window may be resized 


INTERRUPT 16h - Function FFh, Subfunction B6h 
GET Unknown Values 


Purpose: unknown. 


Available on: All machines, Restrictions: PC Tools version 5.5 or higher 
DESKTOP must be installed, 

Registers at call: Return Registers: 

AX = FFB6h AH = unknown. 


AL = unknown. 
Conflicts: None known. 


INTERRUPT 16h - Function FFh, Subfunction B7h 
GET/SET Unknown Buffer 


Purpose: unknown. 
Available on: All machines. Restrictions: PC Tools version 5.5 or higher 
DESKTOP must be installed. 
Registers at call: Return Registers: 
AX = FFB7h data copied 
BX = direction 
0000h copy to buffer 
else copy from buffer 
DS:SI -> 70-byte buffer with unknown data 
Details: This function is available only when popped up under version 6.0 or higher. 
Conflicts: None known. 


INTERRUPT 16h - Function FFh, Subfunction B8h 
GET/SET Unknown Values 


Purpose: unknown. 


Available on: All machines. 


Registers at call: 

AX = FFB8h 

BH = subfunction 
00h get 


nonzero set 
BL = new value for unknown 
CL = new value for unknown (v6.0+) 
CH = new value for unknown (v6.0+) 
DH = unknown. 
Conflicts: None known. 


INTERRUPT 16h - Function FFh, Subfunction B9h 


Unknown Function 


Purpose: unknown, 
Available on: All machines, 


Registers at call: 


AX = FFB9h 
unknown, 


Conflicts: None known, 


INTERRUPT 16h - Function FFh, Subfunction BAh 


Unknown Function 


Purpose: unknown, 
Available on: All machines. 


Registers at call: 

AX = FFBAh 

unknown, 

Details: This function is only available when popped up. 
Conflicts: None known. 


INTERRUPT 16h - Function FFh, Subfunction BBh 


CLEAR Unknown FLAG 


Purpose: unknown, 
Available on: All machines. 


Registers at call: 

AX = FFBBh 

Details: This function is only available when popped up. 
Conflicts: None known. 

See Also: Function FFh Subfunction B4h 


INTERRUPT 16h - Function FFh, Subfunction BCh 


RESTORE ORIGINAL SCREEN 
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Restrictions: PC Tools version 5.1 or higher 
DESKTOP must be installed. 
Return Registers: 


BL = old value of unknown 
CL = old value of unknown (v6.0+) 
CH = old value of unknown (v6,0+) 


AL = old value replaced by CL (v6.0+) 
AH = old value replaced by CH (v6.0+) 


Restrictions: PC Tools version 5.f or higher 
DESKTOP nuust be installed. 

Return Registers: 

AX = unknown, 

CX = unknown. 

DS:SI -> unknown. 

ES:DI -> unknown. 


Restrictions: PC Tools version 5,1 or higher 
DESKTOP must be installed. 

Return Registers: 

AX = unknown. 


Restrictions; PC Tools version 5.1 or higher 
DESKTOP must be installed. 
Return Registers: n/a 


Purpose: Restore the display to its state at the time the desktop was started or popped up. 
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Available on: All machines. Restrictions: PC Tools version 5.1 or higher 
DESKTOP must be installed. 

Registers at call: Return Registers: n/a 

AX = FFBCh 


Conflicts: None known. 


INTERRUPT 16h - Function FFh, Subfunction BDh 
DATABASE INDEXING MESSAGES 


Purpose: unknown. 


Available on: All machines. Restrictions: PC Tools version 5.1 or higher 
DESKTOP must be installed. 

Registers at call: Return Registers: unknown. 

AX = FFBDh 

unknown. 


Conflicts: None known. 


INTERRUPT 16h - Function FFh, Subfunction BEh 


Unknown Function 

Purpose: unknown, 

Available on: All machines, Restrictions; PC Tools version 5.1 or higher 
DESKTOP must be installed, 

Registers at call: Return Registers: unknown. 

AX = FFBEh 

unknown, 

Details: This function is only available when popped up. 

Conflicts: None known. 

INTERRUPT 16h - Function FFh, Subfunction BFh 

Unknown Function 

Purpose: unknown. 

Available on: All machines. Restrictions; PC Tools version 5.1 or higher 
DESKTOP must be installed. 

Registers at call: Return Registers: unknown, 

AX = FFBFh 

BX = DOS file handle to write on 

other unknown. 

Details: This function is only available when popped up. 

Conflicts: None known. 

INTERRUPT 16h - Function FFh, Subfunction COh 

Unknown Function 

Purpose: unknown. 

Available on: All machines. Restrictions: PC Tools version 5.1 or higher 
DESKTOP must be installed. 

Registers at call: Return Registers: 

AX = FFCOh AX = 0000h if successful 

unknown, AX = FFFFh on error 


Details: This function is only available when popped up. 
Conflicts: None known. 


INTERRUPT 16h - Function FFh, Subfunction Cth 
Unknown Function 


Purpose: unknown. 


Available on: All machines. 


Registers at call: 

AX=FFCih 

BL = unknown. 

ES:DI -> data structure (Table 33-3) 

other registers, if any, unknown. 

Details: This function is only available when popped up. 
Conflicts: None known. 





Table 33-3. Format of Data Structure: 


Offset Size Description 
00h WORD unknown. 
02h WORD unknown, 
04h WORD unknown, 
06h WORD unknown. 
08h WORD unknown, 
OAh BYTE unknown. 
OBh BYTE unknown, 
further unknown, 


INTERRUPT 16h - Function FFh, Subfunction C2h 
Unknown Function 


Purpose: unknown. 
Available on: All machines, 


Registers at call: 
AX = FFC2h 
unknown. 


Details: This function is only available when popped up. 
Conflicts: None known. 
See Also: Function FFh Subfunction C3h 


INTERRUPT 16h - Function FFh, Subfunction C3h 
Unknown Function 

Purpose: unknown, 

Available on: All machines. 


Registers at call: 
AX = FFC3h 
unknown, 


Details: This function is only available when popped up. 
Conflicts: None known, 
See Also: Function FFh Subfunction C2h 


INTERRUPT 16h - Function FFh, Subfunction C4h 
GET Unknown DATA POINTERS 
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Restrictions: PC Tools version 5.1 or higher 
DESKTOP must be installed. 

Return Registers: 

AX = unknown. 


Restrictions: PC Tools version 5.1 or higher 
DESKTOP must be installed, 

Return Registers: 

AH = unknown, 

CX = unknown. 

DH = unknown, 

DL = unknown. 


Restrictions: PC Tools version 5.1 or higher 
DESKTOP must be installed. 

Return Registers: 

AH = unknown. 

CX = unknown, 

DH = unknown. 

DL = unknown. 


Purpose: Determine the addresses of a number of internal data structures. 
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Available on: All machines. 


Registers at call: 
AX = FFC4h 


PC Tools version 5.1 
DESKTOP must be installed, 
Return Registers: 

AL = unknown. 

BX = segment of scratch space 

CX = segment of stored screen data (section covered 
by window) 

DX = segment of window parameters for unknown 
window 

ES:BP -> unknown. 


Restrictions: or higher 


Details: This function is only available when popped up in versions prior to 6.0. 


Conflicts: None known. 


INTERRUPT 16h - Function FFh, Subfunction C5h 
CHECK WHETHER DESKTOP LOADED RESIDENT 


Purpose: Determine whether the PC Tools version 5.1 or higher DESKTOP is loaded as a TSR. 


Available on: All machines, 
Registers at call: 
AX = FFCSh 


Restrictions: none. 

Return Registers: 

BL = nonzero if loaded resident 
= 00h if nonresident 


Details: This function is only available when popped up. Cal] Subfunction EFh first to ensure that DESKTOP is 


actually present. 
Conflicts: None known. 
See Also: Function FFh Subfunctions EFh and F3h 


INTERRUPT 16h - Function FFh, Subfunction C6h 
SET Unknown Value 


Purpose: unknown. 
Available on: All machines. 


Registers at call: 

AX = FFC6h 

BL = new value for uiknown. 
Conflicts: None known. 


INTERRUPT 16h - Function FFh, Subfunction C7h 
REMOVE WINDOW 


Restrictions; PC Tools version 5.1 
DESKTOP must be installed. 
Return Registers: n/a 


or higher 


Purpose: Remove the specified (or possibly the current) window and restore the portion of the screen it covered. 


Available on: All machines, 


Registers at call: 

AX = FFC7h 

unknown, 

Conflicts: None known. 


INTERRUPT 16h - Function FFh, Subfunction C8h 
GET Unknown Pointer 


Purpose: unknown, 
Available on: All machines. 


Registers at call: 
AX = FFC8h 
Details: Valid only while popped up. 


PC Tools version 5.1 
DESKTOP must be installed. 
Return Registers: unknown. 


Restrictions: or higher 


Restrictions: PC Tools version 5.1 
DESKTOP must be installed. 

Return Registers: 

DS:SI -> unknown. 


or higher 
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Conflicts: None known. 


INTERRUPT 16h - Function FFh, Subfunction C9h 
COPY DATA TO CLIPBOARD 


Purpose: Place text into the clipboard for later pasting. 


Available on: All machines. Restrictions: PC Tools version 5.1 or higher 
DESKTOP must be installed. 

Registers at call: Return Registers: 

AX = FFC9h CF set on error 


DS:SI -> characters to store in clipboard 

CX = size in bytes 

Details: This function is only available when popped up. While copying, bytes of 00h and OAh are skipped. 
Conflicts: None known. 


INTERRUPT 16h - Function FFh, Subfunction CAh 


SET Unknown Value 

Purpose: unknown, 

Available on: All machines. Restrictions: PC Tools version 5.1 or higher 
DESKTOP must be installed, 

Registers at call; Return Registers: 

AX =FFCAh AX destroyed 

DX = unknown, 

Details: available only when popped up. 

Conflicts: None known. 

INTERRUPT 16h - Function FFh, Subfunction CBh 

SELECT WINDOW PARAMETERS 

Purpose: Specify the set of window parameters (size, color, etc.) to use. 

Available on: All machines. Restrictions: PC Tools version 5.1 or higher 
DESKTOP must be installed. 

Registers at call: Return Registers: 

AX = FFCBh AX destroyed 

DX = window specifier 

Details: This function is only available when popped up. 

Conflicts: None known. 

See Also: Function FFh Subfunction BSh 

INTERRUPT 16h - Function FFh, Subfunction CCh 

DISPLAY ASCIZ STRING CENTERED N WINDOW 

Purpose: Display the specified string centered within the current window. 

Available on: All machines. Restrictions; PC Tools version 5.1 or higher 
DESKTOP must be installed. 

Registers at call: Return Registers: 

AX = FFCCh AX = unknown. 

DS:SI -> ASCIZ string CX = unknown, 


ES:DI -> address past last character displayed 
(v5.1/5,5 only) 
-> unknown, on menu bar (v6.0) 
Conflicts: None known. 


INTERRUPT 16h - Function FFh, Subfunction CDh 
Unknown Function 


Purpose: unknown. 


| 
| 
i 
| 





33-14 PC Tools 


Available on: All machines. Restrictions: PC Tools version 5.1 or higher 
DESKTOP must be installed. 

Registers at call; Return Registers: unknown. 

AX = FFCDh 


DS:DX -> unknown. 
Details: This function is only available when popped up. 
Conflicts: None known. 


INTERRUPT 16h - Function FFh, Subfunction CEh 
SET Unknown DELAYS 


Purpose: Specify the delays used in unknown situations. 

Available on: All machines. Restrictions; PC Tools version 5.1 or higher 
DESKTOP must be installed. 

Registers at call; Return Registers: apparently nothing 

AX = FFCEh 

CX = unknown, 

Conflicts: None known. 


INTERRUPT 16h - Function FFh, Subfunction CFh 
CLOSE PRINTER/PRINT FILE 


Purpose: Terminate printing. 

Available on: Ali machines. Restrictions: PC Tools version 5.1 or higher 
DESKTOP must be installed. 

Registers at call: Return Registers: n/a 

AX = FFCFh 

Details: available only when popped up 

Conflicts: None known. 


INTERRUPT 16h - Function FFh, Subfunction DOh 
PREPARE TO PRINT 


Purpose: Perform any necessary initializations before printing data. 

Available on: All machines. Restrictions: PC Tools version 5.1 or higher 
DESKTOP must be installed. 

Registers at call: Return Registers: unknown. 

AX = FFDOh 

unknown, 

Details: This function is only available when popped up. 

Conflicts: None known. 


INTERRUPT 16h - Function FFh, Subfunction Dih 
DISPLAY PRINT OPTIONS MENU 


Purpose: Allow the user to select the number of copies to be printed and where to print them. 
Available on: All machines. Restrictions; PC Tools version 5,1 or higher 
DESKTOP must be installed. 
Registers at call: Return Registers: 
AX = FFDIh BX = number of copies 
DX = destination 

OOh cancel 

OLhLPT1 

O2hLPT2 

O3hLPT3 

04hCOM1 
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Details: This function is only available when popped up. 
Conflicts: None known. 


INTERRUPT 16h - Function FFh, Subfunction D2h 


Unknown Function 


Purpose: unknown. 
Available on: All machines. 


Registers at call: 

AX = FFD2h 

BX = unknown, 

Details: This function is only available when popped up. 
Conflicts: None known. 


INTERRUPT 16h - Function FFh, Subfunction D3h 
Unknown Function 


Purpose: unknown, 
Available on: All machines, 


Registers at call: 

AX = FEFD3h 

DS:SI -> 92-byte data record for unknown, 
Conflicts: None known. 


INTERRUPT 16h - Function FFh, Subfunction D4h 
CREATE/OPEN/DELETE FILE 


Purpose: Access or delete the specified data file. 
Available on: All machines. 


Registers at call: 
AX = FFD4h 
BH = 3Ch create file (with no attributes) 
3Dh open file 
41h delete file 
BL = access mode 
00h read only 
O1h write only 
02h read/write 
DS:SI -> ASCIZ filename 
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05hCOM2 
OGhdisk file 


Restrictions: PC Tools version 5.1 or higher 
DESKTOP must be installed. 

Return Registers: 

BL = unknown. 


Restrictions: PC Tools version 5.1 or higher 
DESKTOP must be installed. 
Return Registers: unknown. 


Restrictions; PC Tools version 5.{ or higher 
DESKTOP must be installed. 
Return Registers: 
BX = file handle 
0000h on error 


Details: Operation is attempted in (in order) the directory from which the desktop was started/run, the directory 


specified with the filename, X\PCTOOLS\ and X‘\. 
Conflicts: None known. 


INTERRUPT 16h - Function FFh, Subfunction D5h 
Unknown Function 


Purpose: unknown. 
Available on: All machines. 


Registers at call: 
AX = FFDS5h 
unknown, 


Restrictions: PC Tools version 5.1 or higher 
DESKTOP must be installed. 
Return Registers: unknown. 
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Details: This function is only available when popped up. = 
Conflicts: None known. 


INTERRUPT 16h - Function FFh, Subfunction Dé6h 


Unknown Function 


Purpose: unknown. 

Available on: All machines. Restrictions: PC Tools version 5.1 or higher 
DESKTOP must be installed. 

Registers at call: Return Registers: unknown. 

AX = FFD6h 

BX = unknown. 

CX = unknown. 

DX = offset in unknown. 

other unknown. 

Details: This function is only available when popped up. 

Conflicts: None known, 


INTERRUPT 16h - Function FFh, Subfunction D7h 


Unknown Function 


Purpose: unknown. 

Available on: All machines, Restrictions: PC Tools version 5.1 or higher 
DESKTOP must be installed. 

Registers at call: Return Registers: 

AX = FFD7h BL = unknown, 

other wiknown, 

Details: This function is only available when popped up. 

Conflicts: None known. 


INTERRUPT 16h - Function FFh, Subfunction D8h 
SAFE CREATE FILE 


Purpose: Create a new file, prompting the user for confirmation before overwriting an existing file. 

Available on: All machines. Restrictions; PC Tools version 5.1 or higher 
DESKTOP must be installed. 

Registers at call: Return Registers: 

AX = FFD8h BX = file handle 

DS:BX -> ASCIZ filename 0000h on error 

Details: This function is probably only available when the desktop is popped up. 

Conflicts: None known. 


INTERRUPT 16h - Function FFh, Subfunction D9h 


GET Unknown Value 

Purpose: unknown. 

Available on: All machines, Restrictions: PC Tools version 5.1 or higher 
DESKTOP must be installed. 

Registers at call: Return Registers: 

AX = FFD9h AX = unknown. 


Details: This function is only available when popped up. 
Conflicts: None known. 


INTERRUPT 16h - Function FFh, Subfunction DAh 
GET NAME OF LAST FILE OPENED 


Purpose: Determine the full name of the last file opened via the DESKTOP API. 


| 
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Available on: All machines. Restrictions: PC Tools version 5.! or higher 
DESKTOP must be installed. 

Registers at call: Return Registers: 

AX = FFDAh DS:SI -> filename 


DS:SI -> unknown. (v5.1/5.5 only) 
Conflicts: None known. 


INTERRUPT 16h - Function FFh, Subfunction DBh 
SET Unknown Value 


Purpose: unknown. 





Available on: All machines. Restrictions: PC Tools version 5.1 or higher 
DESKTOP must be installed. 

Registers at call: Return Registers: n/a 

AX = FFDBh 


BL = unknown. 
Details: This function is only available when popped up. 
Conflicts: None known. 


INTERRUPT 16h - Function FFh, Subfunction DCh 


UNHOOK DESKTOP 

Purpose: Restore the interrupt vectors hooked by the desktop in preparation for unloading it from memory. 

Available on: All machines. Restrictions: PC Tools version 5.f or higher 
DESKTOP must be installed. 

Registers at call: Return Registers: 

AX = FFDCh interrupt vectors O9h, 10h (v6.0+), 16h, 1Ch, and 21h 


restored to original values 
Conflicts: None known. 


INTERRUPT 16h - Function FFDDh, Subfunction 0000h 
PCShell INSTALLATION CHECK 


Purpose: Determine whether the PC Tools version 5.1 or higher PCShell is installed. 


Available on: All machines. Restrictions: none. 

Registers at call: Return Registers: 

AX = FFDDh CX = 5555h 

BX = 0000h DX = 5555h if PCShell installed in resident mode 


Conflicts: None known. 


INTERRUPT 16h - Function FFDDh, Subfunction 0001h 

REQUEST POP-UP 

Purpose: Force PCShell to pop up as soon as possible. 

Available on: All machines. Restrictions: PC Tools version 5.1 or higher PCShell 
must be installed. 

Registers at call: Return Registers: n/a 

AX = FEDDh 

BX = 0001h 

Conflicts: None known. 

See Also: Function FFDDh Subfunction 0003h 


INTERRUPT 16h - Function FFDDh, Subfunction 0002h 

GET Unknown Value 

Purpose: unknown. 

Available on: All machines. Restrictions: PC Tools version 5.1 through 5.5 
PCShell must be installed. 
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Registers at call: Return Registers: 
AX =FFDDh AL = 00h unknown. 
BX = 0002h O1h unknown. 


Details: PCShell versions 6.0 and higher display the error message "Incorrect PCRUN version", await a keystroke, 
and abort the current process. 
Conflicts: None known. 


INTERRUPT 16h - Function FFDDh, Subfunction 0003h 
REQUEST POP-UP 


Purpose: Force PCShell to pop up as soon as possible. 

Available on: All machines. Restrictions: PC Tools version 5.1 or higher PCShell 
must be installed. 

Registers at call: Return Registers: n/a 

AX = FFDDh 

BX = 0003h 

Conflicts: None known. 

See Also: Function FFDDh Subfunction 0001h 


INTERRUPT 16h - Function FFDDh, Subfunction 0004h 
GET Unknown Pointer 


Purpose: unknown, 

Available on; All machines. Restrictions: PC Tools version 5.1 or higher PCShell 
must be installed. 

Registers at call: Return Registers: 

AX = FFDDh CF clear if successful 

BX = 0004h DS:SI -> unknown, 

Conflicts: None known. 


INTERRUPT 16h - Function FFDDh, Subfunction 0005h 
Unknown Function 


Purpose: unknown. 

Available on: All machines. Restrictions: PC Tools version 5.1 or higher PCShell 
must be installed. 

Registers at call: Return Registers: unknown, 

AX = FFDDh 

BX = 0005h 

other unknown, 

Conflicts: None known. 


INTERRUPT 16h - Function FFDDh, Subfunction 0006h 


Unknown Function 


Purpose: unknown. 

Available on: All machines. Restrictions: PC Tools version 5.1 or higher PCShell 
must be installed. 

Registers at call: Return Registers: unknown. 

AX = FFDDh 

BX = 0006h 

other unknown. 

Conflicts: None known. 


INTERRUPT 16h - Function FFDDh, Subfunction 0007h 
SET Unknown FLAG 


Purpose: unknown. 
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Available on: All machines. Restrictions: PC Tools version 5.1 or higher PCShell 
must be installed. 

Registers at call: Return Registers: 

AX = FFDDh CF clear if successful 

BX = 0007h CF set on error 


Conflicts: None known. 
See Also: Function FFDDh Subfunction 0008h 


INTERRUPT 16h - Function FFDDh, Subfunction 0008h 


CLEAR Unknown FLAG 

Purpose: unknown. 

Available on: All machines. Restrictions: PC Tools version 5.1 or higher PCShell 
must be installed. 

Registers at call: Return Registers: unknown. 

AX = FFDDh 

BX = 0008h 

Conflicts: None known. 

See Also: Function FFDDh Subfunction 0007h 

INTERRUPT 16h - Function FFDDh, Subfunction 0009h 

GET PCRUN PARAMETERS 

Purpose: Determine the parameters with which PCRUN was invoked. 

Available on: All machines, Restrictions: PC Tools version 6.0 or higher PCShell 
must be installed. 

Registers at call: Return Registers: 

AX = FFDDh CF clear if successful 

BX = 0009h DS:SI -> parameter pointers (Table 33-4) 


CF set on error 
Conflicts: None known. 


Table 33-4. Format of PCRUN Parameter List: 


Offset Size Description 

00h WORD offset of WORD containing unknown. 

02h WORD offset of name of program to execute 

04h WORD offset of 80-byte buffer for unknown. 

06h WORD offset of buffer for unknown. (length in WORD preceding buffer) 
08h WORD offset of buffer for unknown. (length in WORD preceding buffer) 


INTERRUPT 16h - Function FFDDh, Subfunction 000Ah 
PCRUN INSTALLATION CHECK 


Purpose: Determine whether PC Tools version 6.0 or higher PCRUN is installed. 


Available on: All machines, Restrictions: none. 
Registers at call: Return Registers: 
AX = FFDDh CX = 5555h if running 
BX = 000Ah DX = 5555h 


Details: This call also sets an unknown flag. 
Conflicts: None known. 


INTERRUPT 16h - Function FFDDh, Subfunction 000Bh 
Unknown Function 


Purpose: unknown. 
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Available on: All machines. Restrictions: PC Tools version 6.0 or higher PCRUN 
must be installed. 

Registers at call: Return Registers: 

AX = FFDDh CX = 5555h if PCRUN active 

BX = 000Bh DX = 5555h 


other unknown. 
Details: This function also clears the flag set by Function FFDDh Subfunction 000Ah 
Conflicts: None known. 


INTERRUPT 16h - Function FFh, Subfunction DEh 
DISPLAY POPUP MENU 


Purpose: Popup the specified dialog box. 
Available on: All machines, Restrictions; PC Tools version 5.1 or higher 
DESKTOP must be installed. 

Registers at call: Return Registers: 

AX = FFDEh AX = unknown, 

DS:DX -> menu description, must be on a AL appears to be the number of the selected button 
paragraph boundary (see Function FFh 
Subfunction EEh) 

Details: This function is only available when popped up. 

Conflicts: None known, 


INTERRUPT 16h - Function FFh, Subfunction DFh 


Unknown Function 


Purpose: unknown, 

Available on: All machines. Restrictions; PC Tools version 5,1 or higher 
DESKTOP must be installed. 

Registers at call: Return Registers: unknown. 

AX = FFDFh 

other unknown. 

Conflicts: None known. 


INTERRUPT 16h - Function FFh, Subfunction E0h 
Unknown Function 


Purpose: unknown, 

Available on: All machines. Restrictions: PC Tools version 5.1 or higher 
DESKTOP must be installed. 

Registers at call: Return Registers: n/a 

AX = FFEOh 

CX = unknown. 

DX = unknown. 

Details; This function is only available when popped up. 

Conflicts: None known. 


INTERRUPT 16h - Function FFh, Subfunction Eih 
BEEP 


Purpose: Sound a beep. 

Available on: All machines. Restrictions: PC Tools version 5.1 or higher 
DESKTOP must be installed. 

Registers at call: Return Registers: n/a 

AX = FFEth 

Conflicts: None known. 


INTERRUPT 16h - Function FFh, Subfunction E2h 


Unknown Function 


Purpose: unknown. 
Available on: All machines. 


Registers at call: 

AX = FFE2h 

DX = unknown. 

Details: This function is only available when popped up. 
Conflicts: None known. 


INTERRUPT 16h - Function FFh, Subfunction E3h 
PRINT CHARACTER 


Purpose: Send a byte to the current printer or print file. 
Available on: All machines. 


Registers at call: 
AX = FFE3h 
BL = character to print to currently open printer or 
print file 
Details: This function is only available when popped up. 
Conflicts: None known. 


INTERRUPT 16h - Function FFh, Subfunction E4h 


Unknown Function 


Purpose: unknown. 
Available on: All machines. 


Registers at call: 

AX = FFE4h 

DX = segment of unknown, 

Details: This function is only available when popped up. 
Conflicts: None known, 


INTERRUPT 16h - Function FFh, Subfunction ESh 
POP UP FILE SELECTION MENU 


Purpose: Allow the user to select a file. 
Available on: All machines. 


Registers at call: 
AX = FFESh 
DS:SI -> ASCIZ wildcard filespec followed by 
ASCIZ menu title 
DX = segment of window parameters 
Details: This function is only available when popped up. 
Conflicts; None known. 
See Also: Function FFh Subfunction DAh 


INTERRUPT 16h - Function FFh, Subfunction E6h 
CHECK FOR AND GET KEYSTROKE 
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Restrictions: PC Tools version 5.1 or higher 
DESKTOP must be installed. 
Return Registers: unknown, 


Restrictions: PC Tools version 5.1 or higher 
DESKTOP must be installed. 

Return Registers: 

CF clear if successful 

CF set on error 


Restrictions: PC Tools version 5.1 or higher 
DESKTOP must be installed. 
Return Registers: unknown. 


Restrictions; PC Tools version 5.1 or higher 
DESKTOP must be installed. 
Return Registers: 
AX = DOS file handle for file 
DS:DX -> filename 
= FFFFh if cancelled by user 


Purpose: Determine whether any keystrokes are available and read the next keystroke if so. 
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Available on: All machines. Restrictions; PC Tools version 5.1 or higher 
DESKTOP must be installed. 

Registers at call: Return Registers: 

AX = FFEGh AX = 0000h if no key available 


else BIOS keycode 
Details: This function is only available when popped up. Invokes INT 28h idle interrupt before checking for key. 
Conflicts: None known. 


INTERRUPT 16h - Function FFh, Subfunction E7h 


Unknown Function 

Purpose: unknown. 

Available on: All machines. Restrictions: PC Tools version 5.1 or higher 
DESKTOP must be installed. 

Registers at call: Return Registers: unknown. 

AX = FFE7h 

BX = segment of unknown. 

Details: This function is only available when popped up. 

Conflicts: None known. 

INTERRUPT 16h - Function FFh, Subfunction E8h 

DISPLAY NUMBER 

Purpose: Convert a number to a string of characters and attributes suitable for direct display on the screen. 

Available on: All machines. Restrictions: PC Tools version 5.1 or higher 
DESKTOP must be installed. 

Registers at call: Return Registers: 

AX = FFE8h DS:SI buffer filled in with alternating characters and 

CX = number attributes 

DH = attribute 

DS:SI -> destination for ASCII number 

Conflicts: None known. 

INTERRUPT 16h - Function FFh, Subfunction E9h 

GET FILE LIST 

Purpose: Determine the files matching a previous wildcard search. 

Available on: All machines. Restrictions: PC Tools version 5.1 or higher 
DESKTOP must be installed. 

Registers at call: Return Registers: 

AX = FFE9h BX = segment of file/directory list (14 bytes per file, 

NUL-padded) 

Details: This function is only available when popped up. 

Conflicts: None known. 

INTERRUPT 16h - Function FFh, Subfunction EAh 

DISPLAY COUNTED STRING 

Purpose: Output a counted string to the current window. 

Available on: All machines. Restrictions: PC Tools version 5.1 or higher 
DESKTOP must be installed. 

Registers at call: Return Registers: 1nnknown. 

AX = FFEAh 

DS:SI -> counted string (count byte followed by 

string) 


Details: This function is only available when popped up. 
Conflicts: None known. 
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INTERRUPT 16h - Function FFh, Subfunction EBh 

Unknown Function 

Purpose: unknown. 

Available on: All machines. Restrictions: PC Tools version 5.1 or higher 
DESKTOP must be installed. 

Registers at call: Return Registers: unknown. 

AX = FFEBh 

other unknown, 

Conflicts: None known. 


INTERRUPT 16h - Function FFh, Subfunction ECh 

GET KEY 

Purpose: Wait for the next keystroke. 

Available on: All machines. Restrictions; PC Tools version 5.1 or higher 
DESKTOP must be installed. 

Registers at call: Return Registers: 

AX =FFECh AX = keystroke 

DS:SI -> FAR routine to unknown, FFFFh if F10 pressed to go to menu 

BX = unknown, 

unknown. 

Details: This function is only available when popped up. Invokes INT 28h while waiting for keystroke. F10 is 

hotkey to Desktop menu. 

Conflicts: None known. 


INTERRUPT 16h - Function FFh, Subfunction EDh 
GET Unknown Value 


Purpose: unknown, 


Available on: All machines, Restrictions: PC Tools version 5.1 or higher 
DESKTOP must be installed. 

Registers at call: Return Registers: 

AX = FFEDh AX = unknown. 


Details: This function is only available when popped up. 
Conflicts: None known. 


INTERRUPT 16h - Function FFh, Subfunction EEh 


DEFINE PULLDOWN MENUS 

Purpose: Specify the contents of the pulldown menus at the top of the screen. 

Available on: All machines. Restrictions: PC Tools version 5.1 or higher 
DESKTOP must be installed. 

Registers at call: Return Registers: 

AX = FFEEh AX destroyed 


DS:SI -> pulldown menu system description 
(Table 33-5) 
Details: This function is only available when popped up. If the accessory does not need any menu items of its own, it 
should call Function FFh Subfunction FAh instead. 
Conflicts: None known. 
See Also: Function FFh Subfunctions F7h and FAh 
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Table 33-5. Format of Pulldown Menu System Description: 


Offset Size Description 

00h WORD offset of menu bar contents (counted string) 

02h WORD number of items on menu bar 

04h 10 BYTEs scan codes for hotkeying to each of up to ten menu items 
OEh 10 BYTEs which character to highlight in each menu item (Olh=first) 
18h WORD offset of first menu definition (Table 33-6) 


1Ah WORD offset of second menu definition 


Table 33-6. Format of Menu Definition: 





Offset Size Description 
00h WORD offset of menu contents (Table 33-7) 
02h WORD number of entries in menu 
04h for each entry: 
Offset Size Description 
00h BYTE _ scancode of Alt-key to invoke entry 
Olh BYTE _ character to highlight (Olh=first, etc) 
02h WORD offset of FAR routine to handle selection 


Table 33-7. Format of Menu Contents: 


Offset Size Description 

00h BYTE number of lines in menu 

Olh BYTE width of menu 

02h NBYTEs counted strings, one for each line in menu 


INTERRUPT 16h - Function FFh, Subfunction EFh 
DESKTOP INSTALLATION CHECK 


Purpose: Determine whether the PC Tools version 5.1 or higher DESKTOP is running or installed resident. 


Available on: All machines. Restrictions: none. 

Registers at call: Return Registers: 

AX = FFEFh CX = ABCDh if PC Tools DESKTOP.EXE is installed 
CX = 0000h BX = segment of resident portion 


AX = unknown. (v5.1/5.5 only) 
Conflicts: None known. 
See Also: Function FFh Subfunctions C5h and F3h 


INTERRUPT 16h - Function FFh, Subfunction FOh 


SET Unknown Value 

Purpose: unknown, 

Available on: All machines. Restrictions: PC Tools version 5.1 or higher 
DESKTOP must be installed, 

Registers at call: Return Registers: 

AX = FFFOh AX destroyed 


DX = unknown. 
Details: This function is only available when popped up. 
Conflicts: None known. 


INTERRUPT 16h - Function FFh, Subfunction Fih 
ALTERNATE INSTALLATION CHECK 


Purpose: Determine whether the PC Toolvs version 5.1 or higher DESKTOP is running or installed resident. 
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Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 

AX = FFFIh CX = 5555h if installed 
BX =0000h leave unknown flag as is DX = 5555h 


nonzero set the flag 
Conflicts: None known, 


INTERRUPT 16h - Function FFh, Subfunction F2h 


DISPLAY HELP LINE 

Purpose: Display a line of help or function key labels on the last line of the screen. 

Available on: All machines. Restrictions; PC Tools version 5.1 or higher 
DESKTOP must be installed. 

Registers at call: Return Registers: 

AX = FFF2h AX destroyed 


DS:SI -> ASCIZ function key label string (each 
label preceded by ‘[') or help text 
Details: This function is only available when popped up. If the specified string does not start with ‘[', it is displayed 
centered on the bottom line, else the function key labels are shown. 
Conflicts: None known. 


INTERRUPT 16h - Function FFh, Subfunction F3h 
PREPARE TO UNLOAD RESIDENT DESKTOP 


Purpose: Indicate to the resident portion that DESKTOP is about to be removed from memory and should release 
any EMS being used; restore the video mode, page, and cursor shape; and restore all modified interrupt vectors. 


Available on: All machines. Restrictions: PC Tools version 5.1 or higher 
DESKTOP must be installed as a TSR. 

Registers at call: Return Registers: n/a 

AX = FFF3h 


Conflicts: None known, 
See Also: Function FFh Subfunctions CSh and EFh 


INTERRUPT 16h - Function FFh, Subfunction F4h 


Unknown Function 

Purpose: unknown. 

Available on: All machines, Restrictions: PC Tools version 5.1 or higher 
DESKTOP must be installed. 

Registers at call: Return Registers: unknown. 

AX = FFF4h 

unknown, 


Details: This function is only available when popped up. 
Conflicts: None known. 
See Also: Function FFh Subfunction F6h 


INTERRUPT 16h - Function FFh, Subfunction F5h 
GET SCREEN ATTRIBUTE ARRAY 


Purpose: Determine the attributes used by various portions of the PC Tools desktop, 


Available on: All machines. Restrictions: PC Tools version 5.1 or higher 
DESKTOP must be installed. 

Registers at call: Return Registers: 

AX = FFF5h ES:BX -> sereen attributes data structure (Table 33-8) 


AL = unknown, (v6.0+) 
Conflicts: None known. 
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Table 33-8. Format of Attribute Data Structure: 


Offset Size Description 

-l BYTE attribute for desktop background 

00h BYTE attribute for normal characters on desktop menu 
Olh BYTE attribute for highlighted characters on desktop menu 
02h SBYTEs unknown. 

07h BYTE attribute for dialog boxes 

08h 1S BYTEs unknown. 

17h BYTE attribute for message boxes 


INTERRUPT 16h - Function FFh, Subfunction Féh 
INVOKE NOTEPAD EDITOR 


Purpose: Start the editor on the specified file. 
Available on: All machines. Restrictions: PC Tools version 5.1 or higher 
DESKTOP must be installed. 
Registers at call: Return Registers: unknown. 
AX = FFF6h 
DS = segment of editor buffer structure (Table 33- 
9) 
BX = unknown. 
DX = segment of window parameters structure (see 
Function FFh Subfunction BSh) 
Details: This function is only available when popped up. 
Conflicts: None known. 
See Also: Function FFh Subfunction F4h 


Table 33-9, Format of Editor Buffer Structure: 


Offset Size Description 

00h WORD offset of current cursor position in buffer segment 
02h 2BYTEs unknown. 

04h WORD offset of beginning of file data in buffer segment 
06h 10BYTEs unknown. 

10h NBYTEs ASCIZ name of file being edited 


INTERRUPT 16h - Function FFh, Subfunction F7h 
PROCESS MENU BAR ENTRY 


Purpose: Perform input processing on the menu bar set up with Function FFh Subfunction EEh. 

Available on: All machines, Restrictions: PC Tools version 5.1 or higher 
DESKTOP must be installed. 

Registers at call: Return Registers: unknown. 

AX = FFF7h 

DS:SI -> unknown. 

unknown, 

Details: This function is only available when popped up. 

Conflicts: None known. 

See Also: Function FFh Subfunctions EEh and FBh 


INTERRUPT 16h - Function FFh, Subfunction F8h 
DRAW EMPTY WINDOW 


Purpose: Place an empty window on the screen with the size, position, and colors specified by the indicated window 
parameters. 





PC Tools 33-27 


Available on: All machines. Restrictions: PC Tools version 5.1 or higher 
DESKTOP must be installed. 

Registers at call: Return Registers: n/a 

AX = FFF8h 


DS:0000h -> window parameters structure (see 
Function FFh Subfunction B5h) 

DS:BX -> DWORD to store address of unknown 
location on screen 

Conflicts: None known. 


INTERRUPT 16h - Function FFh, Subfunction F9h 
DEFINE SCREEN REFRESH ROUTINE 


Purpose: Specify the subroutine to be invoked whenever the caller's window needs to be redrawn after another 
application has overwritten it. 


Available on: All machines. Restrictions: PC Tools version 5.1 or higher 
DESKTOP must be installed. 
Registers at call: Return Registers: n/a 
AX = FFF9h 
ES:BX -> FAR routine to redisplay the utility's 
window 


Details: This function is only available when popped up. 
Conflicts: None known. 


INTERRUPT 16h - Function FFh, Subfunction FAh 


DEFINE STANDARD PULLDOWN MENUS 


Purpose: Specify that the calling accessory will not add any pulldown menus to the standard "Desktop" and 
"Window" menus. 


Available on: All machines. Restrictions: PC Tools version 5.1 or higher 
DESKTOP must be installed. 

Registers at call: Return Registers: n/a 

AX = FFFAh 


Details: This function is only available when popped up. Unlike Function FFh Subfunction EEh, no additional menu 
items are added between "Desktop" and "Window", 

Conflicts: None known. 

See Also: Function FFh Subfunctions EEh and FBh 


INTERRUPT 16h - Function FFh, Subfunction FBh 
PROCESS STANDARD MENU BAR 


Purpose: Allow the user to make a selection from the pulldown menus when no accessory-specific menus are 
defined. 


Available on: All machines. Restrictions: PC Tools version 5.1 or higher 
DESKTOP must be installed. 

Registers at call: Return Registers: 

AX = FFFBh unknown. 


Details: This function is only available when popped up. Performs input processing on the standard menu bar set up 
with Function FFh Subfunction FAh. 

Conflicts: None known. 

See Also: Function FFh Subfunction F7h 


INTERRUPT 16h - Function FFh, Subfunction FCh 
GET HOTKEYS AND KEYBOARD VECTOR 


Purpose: Determine the hotkeys used by the desktop and the original vector for INT 09h. 
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Available on: All machines. Restrictions: PC Tools version 5.1 or higher 
DESKTOP must be installed. 

Registers at call: Return Registers: 

AX = FFFCh ES:BX -> hotkey table (Table 33-10) 


DS:DX = original INT 9 vector 
Conflicts: None known. 


Table 33-10. Format of hotkey table: 


Offset Size Description 

00h 2BYTEs  scancode/shift state for desktop hotkey 
02h 2BYTEs — scancode/shift state for clipboard paste key 
04h 2BYTEs — scancode/shift state for clipboard copy key 
06h 2BYTEs — scancode/shift state for screen autodial key 
INTERRUPT 16h - Function FFh, Subfunction FDh 

COPY SCREEN IMAGE 


Purpose: Copies 4000 bytes (probably a screen image) from one unknown location to another under certain 
circumstances. 


Available on: All machines, Restrictions: PC Tools version 5.1 or higher 
DESKTOP must be installed. 

Registers at call: Return Registers: 

AX = FFFDh AX destroyed 


Conflicts: None known. 


INTERRUPT 16h - Function FFh, Subfunction FEh 


SHOW MOUSE CURSOR 

Purpose: Unhide the mouse cursor after updating the screen. 

Available on: All machines. Restrictions; PC ‘Tools version 5.1 or higher 
DESKTOP must be installed. 

Registers at call: Return Registers: n/a 

AX = FFFEh 

Conflicts: None known, 

See Also: Function FFh Subfunction FFh, INT 33h Function 0001h 

INTERRUPT 16h - Function FFh, Subfunction FFh 

HIDE MOUSE CURSOR 

Purpose: Make the mouse cursor invisible in preparation for updating the screen, 

Available on: All machines, Restrictions: PC Tools version 5.1 or higher 
DESKTOP must be installed. 

Registers at call: Return Registers: n/a 

AX = FFFFh 

Conflicts: None known. 

See Also: Function FFh Subfunction FEh, INT 33h Function 0002h 

INTERRUPT 21h - Function FAh 

VDEFEND API 

Purpose: Control the operation of the VDEFEND virus scanner. 

Available on: All machines. Restrictions: PC Tools version 7.0 VDEFEND must 
be installed. 

Registers at call: Return Registers: 

AH = FAh vary with subfunction: 


Dx = 5945h 
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AL = subfunction 
00h null function n/a 


Oth uninstall 
CF set on error 


DI = unknown (apparently 4559h) 


02h set unknown value 


BL = unknown. CF clear 
CL = old value of byte set to BL 


INTERRUPT 2Fh - Function 62h, Subfunction 82h 
FILE PROTECTION 
Purpose: Specify an unknown address, which may be a callback. 
Available on: All machines. Restrictions: PC Tools version 7.0 DATAMON or 
VDEFEND must be installed. 
Registers at call: Return Registers: 
AX = 6282h BX = 0062h 
CX:DX -> unknown. 
DI = segment of unknown or FFFFh (or 0000h, 
VDEFEND only) 
Details: If CX:DX = 0000h:0000h on entry, no action is taken beyond setting BX to 0062h; this serves as an 
installation check, 
Conflicts: None known. 
See Also: Function 62h Subfunction 84h, INT 16h Function FFh Subfunction A3h 


INTERRUPT 2Fh - Function 62h, Subfunction 84h 


DATAMON 
Purpose: Control the operation of the DATAMON file protection program. 
Available on: All machines. Restrictions: PC Tools version 7.0 DATAMON must 
be installed. 
Registers at call: Return Registers: 
AX = 6284h 
BX = function 
0000h installation check 
CX = 0000h AX = resident code segment 
BX =5555h 
CX = 5555h 
0001h unknown 
CX = 0001h AX:BX -> unknown, 
CX = BX 
0002h unknown 
CX = 0002h AX = CX = unknown. 


BX = DX = unknown. 
0003h set unknown flags 
CX = flags n/a 
bit 12: unknown. 
bit 10: unknown, 
bit 5: unknown. 
bit 3: unknown, 
DX = flags 
bit 15: unknown. 
Conflicts: None known. 
See Also: Function 62h Subfunction 82h, INT 16h Function FFh Subfunction A3h 
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Viruses and Anti-Viral Tools 


One of the less attractive features accompanying the free sharing of data files and programs within the microcomputer 
community has been the appearance of "virus" programs, While the term "virus" is validly applied to any program 
that infiltrates a system and reproduces itself, most of the publicized viruses have been characterized by wanton van- 
dalism and destruction of data. 

From a class of programs so rare that many active participants in on-line data exchange considered them to be 
mythical only a few years ago, the virus phenomenen has now become so commonplace that it has given birth to an 
industry devoted to anti-viral programs. 

In this chapter we describe both the disease and some of the cures. This listing is necessarily incomplete; new vi- 
ruses are being created continually, and several of the leading producers of anti-viral programs insist on complete se- 
crecy about their programs’ methods of operation (a not entirely paranoid viewpoint, considering that not too long 
ago, one virus checker was, itself, clandestinely infected and distributed!). 


Viruses Themselves 

We have mixed feelings about providing publicity to the virus programs themselves; however, in the interests of pro- 
viding as complete coverage as possible of the PC’s interrupt usage, we’ve included all those about which we have in- 
formation. Almost all of them hook into the DOS service interrupt 21h; in the following pages they are listed by 
interrupt, function, and subfunction sequence, 


INTERRUPT 21h - Function OBh, Subfunction 56h 
"“Q" virus ~ INSTALLATION CHECK 
Purpose: Determine whether the "G" virus is resident, 


Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AX = 0B56h AX = 4952h if resident 


Conflicts: DOS 1+ Get STDIN Status (chapter 8). 


INTERRUPT 21h - Function 30h, Subfunction F1h 
"Dutch-555" virus - INSTALLATION CHECK 
Purpose: Determine whether virus is already present. 


Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AX = 30FIh 


AL = 00h if resident 
Conflicts: DOS 2+ Get DOS Version (chapter 8), Phar Lap 386/DOS-Extender (chapter 9), CTask 2.0+ (chapter 17). 


INTERRUPT 21h - Function 33h, Subfunction E0h 
“Oropax" virus - INSTALLATION CHECK 


Purpose: Determine whether virus is already present. 


Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AX = 33E0h AL = FFh if resident 


Conflicts: None known. 
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INTERRUPT 21h - Function 35h, Subfunction 7Fh 
"Agiplan" virus - INSTALLATION CHECK 


Purpose: Determine whether virus is already present. 


Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AX = 357Fh DX = FFFFh if installed 


Conflicts: DOS 2+ Get Interrupt Vector (chapter 8). 


INTERRUPT 21h - Function 42h, Subfunction 03h 
"Shake" virus - INSTALLATION CHECK 


Purpose: Determine whether virus is already present. 


Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AX = 4203h "Shake" AX = 1234h if resident 


Conflicts: DOS 2+ Set Current File Position (chapter 8) 


INTERRUPT 21h - Function 42h, Subfunction 43h 
"Invader" virus - INSTALLATION CHECK 


Purpose: Determine whether virus is already present. 

Available on: All machines, Restrictions: none. 
Registers at call: Return Registers: 

AX = 4243h "Invader" AX = 5678h if resident 
Conflicts: DOS 2+ Set Current File Position (chapter 8) 


INTERRUPT 21h - Function 4Bh, various Subfunctions 
VIRUS INSTALLATION CHECKS 


Purpose: Determine whether a virus is already present. 


Available on: All machines. 
Registers at call: 
AX = 4B04h "MG" and "699" 


AX = 4B40h "Plastique" 


AX = 4B4Dh "Murphy-2" 
AX = 4B50h "Plastique-2576" 


AX = 4B59h “Murphy-1" 
AX = 4BAAh “Nomenklatura" 


AX = 4BAFh "948", "Magnitogorsk" 


AX = 4BDDh "Lozinsky" 


AX = 4BFFh "707", “Justice” 


Restrictions: none. 

Return Registers: 

CF clear if "MG" resident 
AX = 044Bh if "699" resident 


AX = 5678h if resident 
See also Function 4Bh Subfunction 41h 


CF clear if resident 


AX = 1234h if resident 
See also Function 4Bh Subfunction 60h 


CF clear if resident 
CF clear if resident 


AL = FAh if "948" resident 
AL = AFh if “Magnitogorsk” resident 


AX = 1234h 


BL = FFh if "707" resident 
DI = 55AAh if "Justice” resident 


INTERRUPT 21h - Function 4Bh, Subfunction 41h 
Unknown Function 


Purpose: unknown. 

Available on: All machines. 

Registers at call: 

AX = 4B4th 

others, if any, unknown. 

See Also: Function 4Bh Subfunction 40h 
Conflicts: None known. 


INTERRUPT 21h - Function 4Bh, Subfunction 60h 
Unknown Function 


Purpose: unknown. 
Available on: All machines. 
Registers at call: 
AX = 4B60h 

others, if any, unknown. 
See Also: Function 4Bh Subfunction 50h 
Conflicts: None known. 


INTERRUPT 21h - Function 52h, Subfunction 52h 
"516" virus - INSTALLATION CHECK 


Purpose: Determine whether virus is already present. 
Available on; All machines. 

Registers at call: 

AX = 5252h 

Conflicts: DOS 2+ internal Get List of Lists (chapter 8), 


INTERRUPT 21h - Function 58h, Subfunction CCh 
"1067" virus - INSTALLATION CHECK 


Purpose: Determine whether virus is already present. 
Available on: All machines, 

Registers at call: 

AX = 58CCh 

Conflicts: None known. 


INTERRUPT 21h - Function 76h 
"Klaeren" virus - INSTALLATION CHECK 


Purpose: Determine whether virus is already present. 
Available on: All machines. 

Registers at call: 

AH = 76h 

Conflicts: None known. 


INTERRUPT 21h - Function 83h 
"SVC" virus - INSTALLATION CHECK 


Purpose: Determine whether virus is already present. 
Available on: All machines. 

Registers at call: 

AH = 83h 

Conflicts: None known. 
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Restrictions: "Plastique" virus must be resident. 
Return Registers: unknown. 


Restrictions: “Plastique-2576" virus must be resident. 
Return Registers: unknown. 


Restrictions: none. 
Return Registers: 
BX = FFEEh if resident 


Restrictions: none. 
Return Registers: 
CF clear if resident 


Restrictions: none. 
Return Registers: 
AL = 48h if resident 


Restrictions: none. 
Return Registers: 
DX = 1990h if resident 
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INTERRUPT 21h - Function 89h 
"Vriest" virus - INSTALLATION CHECK 


Purpose: Determine whether virus is already present. 
Available on: All machines, 

Registers at call: 

AH = 89h 
Conflicts: None 


INTERRUPT 21h - Function 90h 
"Carioca" virus - INSTALLATION CHECK 


Purpose: Determine whether virus is already present. 
Available on: All machines. 

Registers at call: 
AH = 90h 
Conflicts: None 


INTERRUPT 21h - Function 97h, Subfunction 53h 
“Nina” virus - INSTALLATION CHECK 


Purpose: Determine whether virus is already present. 
Available on: All machines. 

Registers at call: 

AX = 9753h 

Conflicts: None known. 


INTERRUPT 21h - Function Ath, Subfunction D5h 
"789" virus - INSTALLATION CHECK 


Purpose: Determine whether virus is already present. 
Available on: All machines. 

Registers at call: 

AX = AIDSh 

Conflicts: Attachmate Extra (chapter 26). 


INTERRUPT 21h - Function ASh, Subfunction 5Ah 
"Eddie-2" virus - INSTALLATION CHECK 


Purpose: Determine whether virus is already present. 
Available on: All machines. 

Registers at call: 

AX = ASSAh 

Conflicts: Attachmate Extra (chapter 26). 


INTERRUPT 21h - Function ABh 
"600" or "Voronezh" virus - INSTALLATION CHECK 


Purpose: Determine whether virus is already present. 
Available on: All machines. 

Registers at call: 

AH = ABh 

Conflicts: None known. 


INTERRUPT 21h - Function BEh 
"Datalock" virus - INSTALLATION CHECK 


Purpose: Determine whether virus is already present. 


nown. 


nown. 





Restrictions: none. 
Return Registers: 
AX = 0123h if resident 


Restrictions: none. 
Return Registers: 
AH = O1h if resident 


Restrictions: none. 
Return Registers: 
never (executes original program) 


Restrictions: none. 
Return Registers: 
AX = 900Dh if resident 


Restrictions: none. 
Return Registers: 
AX = SAA5Sh if resident 


Restrictions: none. 
Return Registers: 
AX = 5555h 
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Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AH = BEh AX = 1234h if resident 


Conflicts: Novell NetWare 4.6/Alloy NTNX (both in chapter 20), "1049" virus (chapter 34). 


INTERRUPT 21h - Function BEh, Subfunction 00h 
"4049" virus « INSTALLATION CHECK 


Purpose: Determine whether virus is already present. 


Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AX = BEOOh CF clear if resident 
CF set 


Conflicts: Novell NetWare 4.6/Alloy NTNX (both in chapter 20), "Datalock" virus (chapter 34). 


INTERRUPT 21h - Function COh 
"Slow" virus, "Solano" virus - INSTALLATION CHECK 


Purpose: Determine whether virus is already present. 


Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AH = COh AX = 0300h if "Slow" resident 


AX = 1234h if "Solano" resident 
Conflicts: Novell NetWare 4.6/Alloy NTNX (both in chapter 20). 
See Also: Function Clh 


INTERRUPT 21h - Function Cth 
"Solano" virus - Unknown Function 


Purpose: unknown, 


Available on: All machines. Restrictions: "Solano" virus must be resident. 
Registers at call: Return Registers: unknown. 
AH=Clh 


other weknown. 
Conflicts: Novell NetWare 4.6/Alloy NTNX (both in chapter 20). 
See Also: Function COh 


INTERRUPT 21h - Function C2h 
"Scott's Valley” virus - Unknown Function 


Purpose: unknown. 


Available on: All machines. Restrictions: "Scott's Valley" virus must be resident. 
Registers at call: Return Registers: unknown. 
AH = C2h 


other unknown. 
Conflicts: Novell NetWare/Alloy NTNX (both in chapter 20). 


INTERRUPT 21h - Function C3h, Subfunction 01h 
"905" virus « INSTALLATION CHECK 


Purpose: Determine whether virus is already present. 


Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 

AX =C301h DX = OEOEh if resident 
DX =FIFIh 


Conflicts: Novell NetWare/Alloy NTNX (both in chapter 20). 
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INTERRUPT 21h - Function C5h, Subfunction 00h 
“Sverdiov" virus - INSTALLATION CHECK 


Purpose: Determine whether virus is already present. 


Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AX = C500h AX = 6731h if resident 


Conflicts: Novell NetWare 4.6/Alloy NTNX (both in chapter 20). 


INTERRUPT 21h - Function C6h, Subfunction 03h 
"Yankee" or "MLTI" virus « INSTALLATION CHECK 


Purpose: Determine whether virus is already present. 


Available on; All machines. Restrictions: none. 
Registers at call: Return Registers: 
AX = C603h CF clear if resident 
CF set 


Conflicts: Novell NetWare/Alloy NTNX (both in chapter 20). 
INTERRUPT 21h - Function CAh, Subfunction 15h 


"Piter" virus - Unknown Function 
Purpose: unknown, 


Available on: All machines. Restrictions: "Piter" virus must be resident 
Registers at call: Return Registers: unknown, 

AX=CAI5h 

unknown. 








Conflicts: Novell NetWare/Alloy NTNX (both in chapter 20). 
See Also: Function CCh 


INTERRUPT 21h - Function CCh 
"Westwood" virus - INSTALLATION CHECK 


Purpose: Determine whether virus is already present. 


Available on; All machines, Restrictions: none. 
Registers at call: Return Registers: 
AH =CCh AX = 0700h if resident 


Conflicts: Novell NetWare/Alloy NTNX (both in chapter 20). 
See Also: Function CDh i 


INTERRUPT 21h - Function CDh 
"Westwood" virus - Unknown Function i 


Purpose: unknown, 


Available on: All machines. Restrictions: "Westwood" virus must be resident. 
Registers at call: Return Registers: unknown, 
AH=CDh 


other, if any, unknown. 
Conflicts: Alloy NTNX (chapter 18), Novell NetWare 4.0 (chapter 20). 
See Also: Function CCh 


INTERRUPT 21h - Function D0h, Subfunction 00h 


"Fellowship" virus - INSTALLATION CHECK 


Purpose: Determine whether virus is already present. 
Available on: All machines. Restrictions: none. 
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Registers at call: Return Registers: 
AX = D000h BX = 1234h if resident 


Conflicts: Alloy NTNX (chapter 18), Novell NetWare 4.6 (chapter 20), Banyan VINES (chapter 22). 


INTERRUPT 21h - Function D5h, Subfunction AAh 
"Diamond-A", "Diamond-B” viruses - INSTALLATION CHECK 


Purpose: Determine whether virus is already present. 


Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AX = DSAAh AX = 2A55h if "Diamond-A" resident 


AX = 2A03h if “Diamond-B" resident 
Conflicts: Alloy NTNX (chapter 18), Novell NetWare 4.0 (chapter 20), Banyan VINES (chapter 22), "Dit" virus 
(chapter 34). 


INTERRUPT 21h - Function D5h, Subfunction AAh 
"Dir" virus - INSTALLATION CHECK 


Purpose: Determine whether virus is already present. 


Available on: All machines. Restrictions: none, 
Registers at call: Return Registers: 
AX = D5AAh SI = 4321h if resident 
BP = DEAAh 


Conflicts: Alloy NTNX (chapter 18), Novell NetWare 4.0 (chapter 20), Banyan VINES (chapter 22), “"Diamond-A", 
"Diamond-B" viruses (chapter 34). 


INTERRUPT 21h - Function DDh 


"Jerusalem"-family viruses - Unknown Function 
Purpose: unknown. 


Available on: All machines, Restrictions: A 'Jerusalem"-family virus must be 
resident. 

Registers at call: Return Registers: unknown. 

AH = DDh 


others, if any, unknown. 
Conflicts: Novell NetWare/Alloy NTNX (chapter 20). 
See Also: Fuctions EOh and EEh 


INTERRUPT 21h - Function DEh 
"April 1st EXE” virus « Unknown Function 


Purpose: unknown. 


Available on: All machines. Restrictions: "April Ist EXE" virus must be resident. 
Registers at call: Return Registers: unknown. 
AH = DEh 


others, if any, unknown. 
Conflicts: "Durban" virus, Novell NetWare (chapter 20). 


INTERRUPT 21h - Function DEh 
"Durban" virus « INSTALLATION CHECK 


Purpose: Determine whether virus is already present. 


Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AH = DEh AH = DFh if resident 


Conflicts: "April 1st EXE" virus, Novell NetWare (chapter 20). 
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INTERRUPT 21h - Function E0h 
“derusalem", “Armagedon” viruses - INSTALLATION CHECK 


Purpose: Determine whether virus is already present. 


Available on: Ail machines. Restrictions: none. 
Registers at call: Return Registers: 
AH=E0h AX = 0300h if "Jerusalem" resident 


AX = DADAh if "Armagedon" resident 
Conflicts: OS/286 and OS/386 (chapter 1), DoubleDOS (chapter 17), Alloy NTNX (chapter 18), Novell NetWare 
(chapter 20), "8-tunes" virus. 
See Also: Functions DDh and DEh 


INTERRUPT 21h - Function E0h, Subfunction OFh 
"B-tunes" virus - INSTALLATION CHECK 


Purpose: Determine whether virus is already present, 


Available on: All machines. Restrictions: none. 
Registers at call; Return Registers: 
AX = EO0Fh AX =4C3Ih if resident 


Conflicts: OS/286 and OS/386 (chapter 1), DoubleDOS (chapter 17), Alloy NTNX (chapter 18), Novell NetWare 
(chapter 20), "Jerusalem", "Armagedon" viruses. 


INTERRUPT 21h - Function E1h 
"Mendoza", "Fu Manchu" viruses - INSTALLATION CHECK 


Purpose: Determine whether virus is already present. 


Available on: All machines, Restrictions: none. 
Registers at call: Return Registers: 
AH=Eith AX = 0300h if "Mendoza" resident 


AX = 0400h if "Fu Manchu" resident 
Conflicts: OS/286 and OS/386 (chapter 1), DoubleDOS (chapter 17), Novell NetWare (chapter 20). 


INTERRUPT 21h - Function E4h 
"Anarkia” virus - INSTALLATION CHECK 


Purpose: Determine whether virus is already present. 


Available on: All machines, Restrictions: none. 
Registers at call: Return Registers: 
AH = E4h AH = 04h if resident 


Conflicts: DoubleDOS (chapter 17), Novell NetWare (chapter 20). 


INTERRUPT 21h - Function E7h 
"Spyer" virus - INSTALLATION CHECK 


Purpose: Determine whether virus is already present. 


Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AH =E7h AH = 78h if resident 


Conflicts: OS/286 and OS/386 (chapter 9), Novell NetWare (chapter 20). 


INTERRUPT 21h - Function ECh, Subfunction 59h 
"Terror" virus - INSTALLATION CHECK 


Purpose: Determine whether virus is already present. 

Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 

AX = ECS9h BP = EC59h if resident 
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Conflicts: DoubleDOS (chapter 16), Alloy NTNX (chapter 18), Novell NetWare 4.6 (chapter 20). 


/ INTERRUPT 21h - Function EEh 
"'Jerusatem-G" virus » INSTALLATION CHECK 


Purpose: Determine whether virus is already present. 





Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AH=EEh AX = 0300h if resident 


Conflicts: DoubleDOS (chapter 16), Alloy NTNX (chapter 18), Novell NetWare 4.6 (chapter 20). 
See Also: Functions DDh and DEh 


INTERRUPT 21h - Function FOh 
"Frere Jacques" virus - INSTALLATION CHECK 


Purpose: Determine whether virus is already present. 


Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AH = FOh AX = 0300h if resident 


Conflicts: None known. 


INTERRUPT 21h - Function F7h i 
"GP1" virus - INSTALLATION CHECK | 


Purpose: Determine whether virus is already present. 





Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AH =F7h AX = 0300h if resident 


Conflicts: None known. 


INTERRUPT 21h - Function FBh, Subfunction 0Ah 
"dBASE" virus - INSTALLATION CHECK 


Purpose: Determine whether virus is already present. 


Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AX = FBOAh AX = OAFBh if resident 


Conflicts: DoubleDOS (chapter 16). 


INTERRUPT 2th - Function FEh, Subfunction 01h 
"Flip" virus - INSTALLATION CHECK 


Purpose: Determine whether virus is already present. 


f 

| Available on: All machines. Restrictions: none. 

i Registers at call: Return Registers: 

i AX = FEOIh AX = O1FEh if resident 


Conflicts: DoubleDOS (chapter 16). 


INTERRUPT 21h - Function FEh, Subfunction 02h 
| "2468" virus - INSTALLATION CHECK 


Purpose: Determine whether virus is already present. 


Available on: All machines. Restrictions: none. i 
Registers at call: Return Registers: i 
AX = FE02h AX = O1FDh if resident 


Conflicts: DoubleDOS (chapter 16). 
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INTERRUPT 21h - Function FEh, Subfunction DCh 
"Black Monday” virus - INSTALLATION CHECK 


Purpose: Determine whether virus is already present. 


Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AX =FEDCh AL = DCh if resident 


Conflicts: PCMANAGE/DCOMPRES (chapter 6), DoubleDOS (chapter 16). 


INTERRUPT 21h - Function FFh 
“Sunday” virus - INSTALLATION CHECK 


Purpose: Determine whether virus is already present. 


Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AH = FFh AX = 0400h if resident 


Conflicts: "PSQR/1720" and "Ontario" viruses, DJ GO32.EXE (chapter 9), Topware Network Operating System 
(chapter 27), CED and DOSED (chapter 36). 


INTERRUPT 21h - Function FFh, Subfunction OFh 
"PSQR/1720" virus - INSTALLATION CHECK 


Purpose: Determine whether virus is already present. 


Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AX = FFOFh AX =0101h if resident 


Conflicts: "Sunday" virus, DJ GO32.EXE (chapter 9), Topware Network Operating System (chapter 27), CED and 
DOSED (chapter 36). 


INTERRUPT 21h - Function FFh, Subfunction FFh 
"Ontario" virus - INSTALLATION CHECK 


Purpose: Determine whether virus is already present. 


Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AX = FFFFh AX = 0000h if resident 


Conflicts: "Sunday" virus, DJ GO32.EXE (chapter 9), Topware Network Operating System (chapter 27), CED and 
DOSED (chapter 36). 


INTERRUPT 32h 
Reportedly used by "Tiny" Viruses 


Purpose: unknown. 


Available on: All machines. Restrictions: A "Tiny’-family virus must be resident. 
Registers at call: Return Registers: 

unknown, unknown, 

Conflicts: None known. 

INTERRUPT 60h 


Zero Bug Virus 
Purpose: The "Zero Bug" virus hooks this vector to provide an installation check. 


Available on: All machines. Restrictions: The Zero Bug virus must be resident. 
Details: The Zero Bug virus considers itself already installed if the two bytes at offset 103h in the handler's segment 
are "ZE", 

Conflicts: See chapter 1. 
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INTERRUPT 6Bh 


Unknown Function 

Purpose: unknown. 

Available on: All machines. Restrictions: "Saddam" virus must be resident. 
Registers at call: unknown. Return Registers: unknown. 

Conflicts: Novell NASI/NACS (chapter 7), Tandy SCHOOLMATE (chapter 36). 


INTERRUPT 70h 


Unknown Function 


Purpose: unknown. 

Available on: All machines. Restrictions: "Stupid" virus must be resident. 
Registers at call; unknown. Return Registers: unknown. 

Conflicts: IRQ8 (chapter 2). 


INTERRUPT E0h 
Unknown Function 


Purpose: unknown, 

Available on: All machines. Restrictions: "Micro-128" virus must be resident. 
Registers at call: sweknown. Return Registers: unknown. 

Conflicts: BASIC interpreter (chapter 1), CP/M-86 function calls (chapter 36). 


Anti-Virals 
Only a few of the anti-viral programs are described here, Those which are covered appear in alphabetic sequence by 


program name, 
INTERRUPT 21h - Function 4Bh, Subfunction EEh 


F-DRIVER,SYS - GRAB INT 21h 


Purpose: When called the first time, this function moves the INT 21h monitoring code from its original location in 
the INT 21h chain to be the first thing called by INT 21h. This is the mechanism used by F-NET. 


Available on: All machines. Restrictions: F-DRIVER.SYS version 1.14 or higher 
must be installed. 

Registers at call: Return Registers: 

AX = 4BEEh AX = 1234h if grab successful 


= 2345h if it failed (INT 21h grabbed previously) 
Details: F-DRIVER.SYS and F-NET are parts of the shareware F-PROT virus/trojan protection package by Fridrik 
Skulason. 
Conflicts: various viruses (see above), ELRES V1.0 (chapter 36). 
See Also: INT 2Fh Function 46h Subfunction 53h 


INTERRUPT 2Fh - Function 46h, Subfunction 53h 


F-DLOCK,EXE 
Purpose: Control F-DLOCK, a hard disk access restrictor. 
Available on: All machines. Restrictions: F-DLOCK must be installed for all calls 
except the installation check. 
Registers at call: Return Registers: 
AX = 4653h installation check: 
CX = 0005h AX = FFFFh 
BX= 0000h_ installation check uninstall: 
0001h uninstall AX,BX,ES destroyed 


Details: F-DLOCK is part of the shareware F-PROT virus/trojan protection package by Fridrik Skulason. 
Conflicts: None known. 
See Also: Function 46h Subfunction 53h/CX=0004h 
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INTERRUPT 2Fh - Function 46h, Subfunction 53h 


F-LOCK.EXE 
Purpose: Control the operation of the F-LOCK operating system restrictor which attempts to detect suspicious 
activity. 
Available on: All machines. Restrictions: F-LOCK must be installed for all calls 
except the installation check. 
Registers at call: Return Registers: 
AX = 4653h Subfunction 0000h: 
CX = 0002h AX = FFFFh 
BX = subfunction Subfunction 0001h: 
0000h installation check AX, BX, ES destroyed 


0001h uninstall 

0002h disable (v1.08 and below only) 

0003h enable (v1.08 and below only) 
Details: F-LOCK is part of the shareware F-PROT virus/trojan protection package by Fridrik Skulason. 
Conflicts: None known. 
See Also: Function 46h Subfunction 53h/CX=0003h, INT 21h Function 4Bh Subfunction EEh 


INTERRUPT 2Fh - Function 46h, Subfunction 53h 


F-POPUP.EXE 
Purpose: Control F-POPUP, the popup menu system for F-PROT. 
Available on: All machines. Restrictions: F-POPUP must be installed for all calls 
except the installation check. 
Registers at call: Return Registers: 
AX = 4653h Subfunction 0000h: 
CX = 0004h AX = FFFFh 
BX = subfunction Subfunction 0001h: 
0000h installation check AX, BX, ES destroyed 
0001h uninstall Subfunction 0003h: 
0002h disable (v1.08 and below only) AX = key pressed by user 


display message (v1.14+) 
other registers: unknown. 
0003h enable (v1.08 and below only) 
display message (v1.14+) 
other registers: unknown. 
Details: F-POPUP is part of the shareware F-PROT virus/trojan protection package by Fridrik Skulason. It is called 
by the F-LOCK and F-DLOCK programs, 
Conflicts: None known. 
See Also: Function 46h Subfunction 53h/CX=0003h,0005h 


INTERRUPT 2Fh - Function 46h, Subfunction 53h 


F-XCHK.EXE 


Purpose: Control the operation of F-XCHK, which prevents the execution of any programs which have not had self- 
checking code added by F-XLOCK, 


Available on: All machines, Restrictions: F-XCHK must be installed for all calls 
except the installation check, 
Registers at call: Return Registers: 
AX = 4653h Subfunction 0000h: 
CX = 0003h AX = FFFFh 
BX = subfunction Subfunction 0001h: 
0000h installation check AX, BX, ES destroyed 


0001h uninstall 


i 
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Details: F-XCHK is part of the shareware F-PROT virus/trojan protection package by Fridrik Skulason. 


Conflicts: None known. 
See Also: Function 46h Subfunction 53h/CX=0002h,0004h 


INTERRUPT 2Fh - Function CAh, Subfunction 00h 
TBSCANX - INSTALLATION CHECK 


Purpose: Determine whether TBSCANX is installed. 


Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AX = CA00h AL = 00h not installed 
BX = 5442h (‘TB’) = FFh installed 


BX = 7462h (‘th’) if BX was 5442h on entry 
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Details; TRBSCANX is a resident virus scanning module by Frans Veldman. Programs may perform virus checks on 


themselves, other program files, or their data files by invoking the TBSCANX API. 
Conflicts: None known. 


INTERRUPT 2Fh - Function CAh, Subfunction 01h 
TBSCANX - GET STATUS 


Purpose: Determine whether TBSCANX is active, how many virus signatures it contains, and where it has stored 


itself. 

Available on: All machines. Restrictions: TBSCANX must be installed. 
Registers at call: Return Registers: 

AX = CAOIh AH = BCD version number (v2.2+) 


= CAh for versions before 2.2 
AL = state (00h = disabled, 01h = enabled) 


CX = number of signatures which will be searched 


=n-V2.0--- 
BX = EMS handle, 0000h if not using EMS 
V2.3 ten0 


BX = segment of swap area, 0000h if not swapped 


DX = EMS handle, FFFFh if not using EMS 


Conflicts: None known. 
See Also: Function CAh Subfunction 02h 


INTERRUPT 2Fh - Function CAh, Subfunction 02h 


TBSCANX - SET STATE 

Purpose: Specify whether TBSCANX should be active. 

Available on: All machines. Restrictions: TBSCANX must be installed. 
Registers at call: Return Registers: n/a 

AX = CA02h 


BL = new state (00h = disabled, OIh = enabled) 
Conflicts: None known. 
See Also: Function CAh Subfunction 01h 


INTERRUPT 2Fh - Function CAh, Subfunction 03h 
TBSCANX - SCAN BUFFER 


Purpose: Request that TBSCANX scan the supplied buffer for virus signatures. 


Available on: Ali machines. Restrictions: TBSCANX must be installed. 
Registers at call: Return Registers: 
AX =CA03h CF clear if no virus signatures found 


BX,ES destroyed 
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CX = size of buffer CF set if signature found 

DS:DX -> buffer containing data to scan ES:BX -> ASCIZ virus name (v2.3+) 
DS:DX -> ASCIZ virus name (v2.0) 
AX,CX,DX destroyed (v2.3+) 
all other registers except CS:IP and SS:SP 

destroyed (v2.0) 
Conflicts: None known. 
See Also: Function CAh Subfunction 04h 


INTERRUPT 2Fh - Function CAh, Subfunction 04h 
TBSCANX - SCAN FILE 


Purpose: Request that TBSCANX scan the specified file for virus signatures. 


Available on: All machines. Restrictions: TBSCANX must be installed. 
Registers at call: Return Registers: 

AX = CA04h CF clear if no virus signatures found 
DS:DX -> filename BX,ES destroyed 


CF set if signature found 
ES:BX -> ASCIZ virus name 
AX,CX,DX destroyed 
Details: This function requires at least 4K free memory. 
Conflicts: None known. 
See Also: Function CAh Subfunction 03h 


INTERRUPT 2Fh - Function C9h, Subfunction 00h 
ThunderByte - INSTALLATION CHECK 


Purpose: Determine whether ThunderByte is installed. 


Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AX = C900h AL = FFh if installed 
BP =0000h BP >= 0014h 


Details: This function is called by TBSCANX. 
See Also: Function C9h Subfunction 87h, Function CAh Subfunction 00h 


INTERRUPT 2Fh - Function C9h, Subfunction 87h 
ThunderByte - DISINFECT FILE 


Purpose: Called by TBSCANX, apparently to disinfect an executable, 


Available on: All machines, Restrictions: ThunderByte must be installed. 
Registers at call: Return Registers: 

AX = C987h AX = status 

BX:DX -> filename 0000h successful 


BX:CX -> virus name 
See Also: Function CAh Subfunction 00h 


INTERRUPT 21h - Function FAh 
VDEFEND 


This function is described in chapter 33 (PC Tools). 


INTERRUPT 2Fh - Function 62h 
VDEFEND 


This function is described in chapter 33 (PC Tools). 


i 
‘ 
i 
| 








| 
| 
} 





Chapter a 45 





Programming Language Runtime Support 


Most high-level languages include a sizable runtime library of useful (and even essential) subroutines. A number of 
them use interrupts rather than direct calls to invoke or control functions in the runtime library, In this chapter, we 


cover floating-point emulation, overlays, JPI TopSPEED Modula-2, Logitech Modula-2, Exact, and BASIC. 


Both Borland International and Microsoft Corporation use the same group of interrupts to emulate numeric 
coprocessor floating-point operations. Each interrupt emulates a specific coprocessor opcode. Typically, the compiler 
outputs either an FWAIT or a NOP instruction followed by the desired coprocessor instruction and a special linker 
fixup record, When linked with a coprocessor-only math library, the fixup records have no effect, but when linked 
with the emulator library, the FWAIT/NOP and opcode of each coprocessor instruction become the appropriate INT 


instructions, 


These interrupts use registers on entry and exit only to the extent that the emulated instructions use them; in most 


cases, registers are either not used at all or used only to specify the memory operand of an instruction. 


INTERRUPT 34h 
Borland/Microsoft languages - Floating Point emulation 


Purpose: Emulate coprocessor instructions with opcode D8h, 
Available on: All machines. Restrictions: Program using the floating point 
emulator must be running. 


Conflicts: None known. 


INTERRUPT 35h 
Borland/Microsoft languages - Floating Point emulation 


Purpose: Emulate coprocessor instructions with opcode D9h, 
Available on: All machines. Restrictions: Program using the floating point 
emulator must be running, 


Conflicts: None known. 


INTERRUPT 36h 
Borland/Microsoft languages - Floating Point emulation 


Purpose: Emulate coprocessor instructions with opcode DAh. 
Available on: All machines. Restrictions: Program using the floating point 
emulator must be running. 


Conflicts: None known. 


INTERRUPT 37h 
Borland/Microsoft languages « Floating Point emulation 
Purpose: Emulate coprocessor instructions with opcode DBh. 


Available on: All machines. Restrictions: Program using the floating point 
emulator must be running. 


Conflicts; None known. 
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INTERRUPT 38h 
Borland/Microsoft languages - Floating Point emulation 


Purpose: Emulate coprocessor instructions with opcode DCh. 
Available on: All machines. Restrictions: 


Conflicts: None 


INTERRUPT 39h 
Borland/Microsoft languages - Floating Point emulation 


Purpose: Emulate coprocessor instructions with opcode DDh. 
Available on: All machines. Restrictions: 


nown. 


Conflicts: None 


INTERRUPT 3Ah 


Borland/Microsoft languages - Floating Point emulation 


Purpose: Emulate coprocessor instructions with opcode DEh. 
Available on: All machines. 


nown. 


Restrictions: 


Conflicts: None 
INTERRUPT 3Bh 
Borland/Microsoft languages - Floating Point emulation 


Purpose: Emulate coprocessor instructions with opcode DFh. 
Available on: All machines. 


nown, 


Restrictions: 





Conflicts: None 


INTERRUPT 3Ch 
Borland/Microsoit languages - Floating Point emulation 


Purpose: Emulate coprocessor instructions with a segment override. 
Available on: All machines. Restrictions: 


nown, 


Program using the floating 
emulator must be running. 


point 


Program using the floating 
emulator must be running. 


point 


Program using the floating 
emulator must be running. 


point 


Program using the floating 
emulator must be running. 


point 


Program using the floating point 
emulator must be running. 


Details: The generated code is CDh 3Ch xy mm... where xy is a modified ESC instruction and mm is the modR/M 


byte. The xy byte is encoded as either 


ssO1LIXxx 
or 
ssQOOxxx 
(depending on the implementation), where "ss" 
00 -> DS: 
01 -> SS: 
10 -> CS: 
11 -> ES: 
Conflicts: None known. 
INTERRUPT 3Dh 
Borland/Microsoft languages - Floating Point emulation 
Purpose: Emulate a standalone FWAIT instruction. 
Available on: All machines. Restrictions: 


Conflicts: None known. 


specifies the segment override: 


Program using the floating point 
emulator must be running. 
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INTERRUPT 3Eh 
Borland languages - Floating Point emulation "shortcut" calf 
Purpose: Provide a number of common functions which do not necessarily correspond to a single floating point 


instruction. 
Available on: All machines. Restrictions: Program using the Borland floating point 


emulator (Turbo Pascal, Turbo C, Turbo 

BASIC, Quattro Pro) must be running. 
Details: The two bytes following the INT 3Eh instruction are the subcode (Table 35-1) and a NOP (90h), The 
shortcut call has been changed for Borland C++ version 2; it now supports only subcodes E6h through FEh, and at 
the time of writing it was not yet known whether those subcodes correspond to the subcodes in earlier products. 
Conflicts: None known. 


Table 38-1. Values of Shortcut Subcodes: 
Subcode Description 


DCh load 8086 stack with 8087 registers 

DEh load 8087 registers from 8086 stack 

E0h round TOS and R1 to single precision, compare, pop twice 

E2h round TOS and R1 to double precision, compare, pop twice; Note: apparently buggy in Turbo Pascal 
5.5, actually rounding to single precision. 

E4h compare TOS/R1 with two POP's 

E6h compare TOS/R1 with POP 

E8h FTST (check TOS value) 

EAh FXAM (check TOS value) 

ECh sine 

EEh cosine 

FOh tangent 

F2h arctangent 

F4h Ln (FLDLN2 to TOS) 

F6h Log2 (FLDLG2 to TOS) 

F8h Log10 (FLDILG10 to TOS 

FAh Exp (FLDL2E to TOS) 

FCh TOS = 2**TOS 

FEh TOS = 10**TOS 

Overlay Managers 


When using overlays, a mechanism is needed to permit calling functions which may not be in memory, and loading 
them if necessary. Microsoft chose to do so using a software interrupt; loading a 16-bit register and calling an 
interrupt requires a total of five bytes, the same as a far CALL. This allows the overlay linker to perform the 
necessary fixups to create the overlaid executable. 


INTERRUPT 3Fh 
Microsoft Dynamic Link Library manager 


Purpose: Provide DLL services such as loading libraries on the first access. 

Available on: All machines. Restrictions: Dynamic Link Library manager must be 
active. 

Conflicts: None known. 


INTERRUPT 3Fh 
Overlay manager interrupt (Microsoft LINK.EXE, Borland TLINK VROOMM) 


Purpose: Invoke the specified overlay, loading it into memory if not presently there. 

Available on: All machines. Restrictions: Must be running a program using an 
internal overlay manager. 

Registers at call: unknown. Return Registers: unknown. 
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Details: INT 3Fh is the default, and may be overridden while linking. 


Conflicts: None known. 


JPI TopSPEED Modula-2 


INTERRUPT 60h 
Procedure Entry Trap 


Purpose: Call a debugging or profiling routine on entry to a procedure, in order to determine which procedure is 


active or how much time is spent in each procedure. 
Available on: All machines. 


Registers at call: 

unknown 

Conflicts: See Table 1-3 (chapter 1). 
See Also: INT 61h 


INTERRUPT 61h 


Procedure Exit Trap 


Restrictions: A program written using JPI TopSPEED 
Modula-2 version must be running. 
Return Registers: n/a 


Purpose: Call a debugging or profiling routine when leaving a procedure, in order to determine which procedure is 


active or how much time is spent in each procedure. 
Available on: All machines, 


Registers at call: 

unknown 

Conflicts: See Table 1-3 (chapter 1). 
See Also: INT 60h 


Logitech Modula-2 


INTERRUPT E4h - Function 00h, Subfunction 05h 
Monitor Entry 


Purpose: unknown. 
Available on: All machines. 


Registers at call: 

AX = 0005h 

BX = priority 

Conflicts: BASIC interpreter (chapter 1). 
See Also: Function 00h Subfunction 06h 


INTERRUPT E4h - Function 00h, Subfunction 06h 
Monitor Exit 


Purpose: unknown, 
Available on: All machines. 


Registers at call: 

AX = 0006h 

Conflicts: BASIC interpreter (chapter 1). 
See Also: Function 00h Subfunction 05h 


Restrictions: A program written using JPI TopSPEED 
Modula-2 version must be running. 
Return Registers: n/a 


Restrictions: A program written using Logitech 
Modula-2 version 2 must be running. 
Return Registers: n/a 


Restrictions: A program written using Logitech 
Modula-2 version 2 must be running. 
Return Registers: n/a 
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EXACT 


The following interrupt is the interface from applications to the runtime system by Exact Automatisering B.V. of the 
Netherlands. By using this interrupt, it can provide DLL-style capabilities under MSDOS. 


INTERRUPT ECh 
Exact - RUNTIME INTERFACE MULTIPLEXOR 


Purpose: Invoke the Exact runtime system. 


Available on: Ali machines. Restrictions: The Exact runtime system must be 
installed. 

Registers at call: Return Registers: 

AX = function number (0000h to 0140h) STACK: _ return address popped, but otherwise 

STACK: DWORD address to return to unchanged 


any arguments required by function 
Details: The interrupt handler removes the return address and flags placed on the stack by the INT ECh, then jumps 
to the appropriate function. 
Conflicts: BASIC interpreter (chapter [). 


BASIC 


In addition to the two below, the IBM ROM BASIC interpreter uses interrupts 86h through EEh to allow extensions 
and execution tracing; those interrupts are mentioned briefly in chapter |. 


INTERRUPT EFh 

ORIGINAL INT 09h VECTOR 

Purpose: Stores the address of the handler for INT 09h that was current before BASIC was started. 

Available on: All machines. Restrictions: Valid only while BASIC (interpreted or 
compiled) is running. 

Registers at call: n/a Return Registers: n/a 


Details: IBM BASIC.COM/BASICA.COM do not restore this vector on termination. 
Conflicts: GEM interface (chapter 36) 


INTERRUPT F0h 

ORIGINAL INT 08h VECTOR 

Purpose: Stores the address of the handler for INT 08h that was current before BASIC was started. 

Available on: All machines, Restrictions: Valid only while BASIC (interpreted or 
compiled) is running, 

Registers at call: n/a Return Registers: n/a 


Details: IBM BASIC,COM/BASICA.COM do not restore this vector on termination. 
Conflicts: None known, 
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Miscellaneous APIs 





‘The preceding 35 chapters of this volume have grouped the various services that use the interrupt structure such that 
similar services are described in the same chapters. Now, however, we’ve reached the end of the book, so this chapter 
describes "everything else" (ranging from alternative command interpreters through sound interfaces, with varied 
stops in between). 

In this chapter, the descriptions are arranged in alphabetic sequence by service/program/library name, and within 
each such group, by numeric sequence of interrupt, function, and subfunction. 


4D0S 


4DOS, from JP Software, is an alternative command interpreter that replaces COMMAND.COM in all versions of 
MS-DOS from 2.1 through 5.0, and also works with DOS-compatible alternative operating systems such as DR-DOS. 
In addition to the calls listed here, the KEYSTACK.SYS driver included with 4DOS supports INT 21h Function 44h 
Subfunction 03h (see chapter 8). 


INTERRUPT 2Eh - Function E22Eh 

SHELL2E,COM- UNINSTALL 

Purpose: Causes SHELL2E to uninstall itself. SHELL2E.COM is a utility that emulates some actions of COM- 
MAND.COM’s undocumented "backdoor" entry to permit use of programs (notably NetWare) that require these ac- 
tions when the 4DOS command interpreter is installed. 


Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 

BX = E22Eh If successful, SHELL2E terminates itself with INT 21h 
DS:SI -> zero byte Function 4Ch 
Conflicts: None known. 

INTERRUPT 2Fh - Function D44Dh, Subfunction 00h 

INSTALLATION CHECK 

Purpose: Determine whether 4DOS version 2.1 or higher is installed. 

Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 

AX = D44Dh AX = 44DDh 

BH = 00h BL = minor version number 


BH = major version number 
CX = PSP segment address for current invocation 
DL =4DOS shell number (0 for the first (root) shell, 
updated each time a new copy is loaded) 
Details: A bug in version 3.00 will crash the system if BH contains an unrecognized subfunction number on entry. 
Conflicts: None known. 


INTERRUPT 2Fh - Function D44Dh, Subfunction 01h 
internal - TERMINATE CURRENT COPY OF 4D0S 


Purpose: Exit the current invocation of 4DOS.COM when the 4DOS.EXE it loaded terminates. 
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Available on: All machines. Restrictions: 4DOS version 2.1 or higher must be 
installed. 

Registers at call: Return Registers: n/a 

AX =D44Dh 

BH=0Olh 


Details: A bug in version 3.00 will crash the system if BH contains an unrecognized subfunction number on entry. 
Conflicts: None known. 


INTERRUPT 2Fh - Function D44Dh, Subfunction 02h 


Unknown Function 

Purpose: unknown. 

Available on: All machines. Restrictions: 4DOS version 2.! or higher must be 
installed. 

Registers at call: Return Registers: unknown. 

AX = D44Dh 

BH=02h 


DX = unknown. 
Details: A bug in version 3.00 will crash the system if BH contains an unrecognized subfunction number on entry. 
Conflicts: None known. 


INTERRUPT 2Fh - Function D44Dh, Subfunction 03h 


EXEC PROGRAM 

Purpose: Execute a child program. 

Available on: Ali machines. Restrictions: 4DOS version 2.1 or higher must be 
installed. 

Registers at call: Return Registers: unknown. 

AX = D44Dh 

BH = 03h 


CX:DX -> EXEC record (Table 36-1) 

Details: A bug in version 3.00 will crash the system if BH contains an unrecognized subfunction number on entry. 
Conflicts: None known. 

See Also: INT 21h Function 4Bh (chapter 8) 


Table 36-1, Format of EXEC Record: 


Offset Size Description 

00h WORD offset of ASCIZ program name in same segment as EXEC record 

02h WORD offset of DOS commandline in same segment as EXEC record 

04h WORD segment of environment for child process (see INT 21h Function 26h, chapter 8) 


INTERRUPT 2Fh - Function D44Dh, Subfunction FEh 
DEALLOCATE SHELL NUMBER 


Purpose: Release the shell number allocated to the calling invocation of 4DOS. 


Available on: All machines. Restrictions: 4DOS version 2.1 or higher must be 
installed. 

Registers at call: Return Registers: n/a 

AX = D44Dh 


BH = FEh deallocate shell number (passed through 

to root shell) 
Details: A bug in version 3.00 will crash the system if BH contains an unrecognized subfunction number on entry. 
Conflicts: None known. 
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INTERRUPT 2Fh - Function D44Dh, Subfunction FFh 

ALLOCATE SHELL NUMBER 

Purpose: Request a shell number for use in creating unique swap files. 

Available on: All machines. Restrictions; 4DOS version 2.1 or higher must be 
installed. 

Registers at call: Return Registers: unknown. 

AX = D44Dh 

BH = FFh allocate shell number (passed through to 


root shell) 
Details: A bug in version 3.00 will crash the system if BH contains an unrecognized subfunction number on entry, 


Conflicts: None known. 


INTERRUPT 2Fh - Function D4h, Subfunction 4Eh 


AWAITING USER INPUT 

Purpose: Provides hooks for user programs to know when command interpreter is at prompting leve. 

Available on: All machines. Restrictions: 4DOS version 3.0 or higher must be 
running. 

Registers at call: Return Registers: 

AX = D44Eh Handler must preserve SI, DI, BP, SP, DS, ES, and SS 

--4DOS v3.01+ 


BX = 0000h 4DOS is ready to display prompt 
= 0001h 4DOS has displayed the prompt, and is 
about to accept user input 
Details: Version 3.00 only makes the call corresponding to BX=0001h, and does not set BX. 
Conflicts: None known. 


Ad Lib SOUND.COM 


INTERRUPT 65h 
SOUND.COM INTERFACE 
Purpose: Control the Ad Lib sound board's driver. 
Available on: All machines. Restrictions: SOUND.COM must be installed. 
Registers at call: Return Registers: 
SI = function number (see the separate entries varies by function 
below for details on several) 

= 0000h Init 

= 0002h RelTimeStart 

= 0003h SetState 

= 0004h GetState 

= 0005h Flush 

= 0006h SetMode 

= 0007h GetMode 

= 0008h SetRel Volume 

= 0009h SetTempo 

= 000Ah SetTranspose 

= 000Bh GetTranspose 

= 000Ch SetActVoice 

= 000Dh GetActVoice 

= 000Eh PlayNoteDel 

= 000Fh PlayNote 

= 0010h SetTimbre 

= 001 1h SetPitch 
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= 0012h SetTickBeat 
= 0013h NoteOn 
= 0014h NoteOff 
= 0015h Timbre 
= 0016h SetPitchBend 
= 0017h WaveForm 
ES:BX -> arguments 
Details: The installation check consists of checking for the signature block immediately preceding the interrupt 
handler (Table 36-2), 
Conflicts: See chapter 1. 


Table 36-2. Format of Signature Block: 


Offset Size Description 

00h WORD version number 

02h 19BYTEs "SOUND-DRIVER-AD-LIB" 

15h BYTE Olh 

16h BYTE QOlh 

17h BYTE 00h 

INTERRUPT 65h - Function 0000h 
INITIALIZE (RESET) 
Purpose: Return the sound board and driver to a known initial state. 
Available on: Systems equipped with an Ad Lib Restrictions; SOUND.COM must be installed. 

sound board. 

Registers at call: Return Registers: n/a 
SI = 0000h 


Conflicts: See chapter 1. 


INTERRUPT 65h - Function 0003h 
SET STATE 


Purpose: Specify whether the sound board should be active. 
Available on: Systems equipped with an Ad Lib Restrictions: SOUND.COM must be installed. 
sound board. 
Registers at call: Return Registers: n/a 
SI = 0003h 
ES:BX -> WORD state 
= 0000h disabled 
= 0001h enabled 
Conflicts: See chapter 1. 
See Also: Function 0004h 


INTERRUPT 65h - Function 0004h 
GET STATE 


Purpose: Determine whether the sound board is currently active. 
Available on: Systems equipped with an Ad Lib Restrictions: SOUND.COM must be installed. 
sound board. 
Registers at call: Return Registers: 
ST =0004h AX = 0000h all done playing sounds 
else still playing sounds 
Conflicts: See chapter 1. 
See Also: Function 0003h 
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INTERRUPT 65h - Function 0006h 


SET MODE 

Purpose: Specify the type of sound to be played by the sound board. 

Available on: Systems equipped with an Ad Lib Restrictions: SOUND.COM must be installed. 
sound board. 

Registers at call: Return Registers: n/a 

SI = 0006h 


ES:BX -> WORD mode 
= 0000h melodic 
= 0001h percussive 
Conflicts: See chapter 1. 


See Also: Function 0007h 

INTERRUPT 65h - Function 0007h 

GET MODE 

Purpose: Determine the type of sound the board is supposed to be playing. 

Available on: Systems equipped with an Ad Lib Restrictions: SOUND.COM must be installed. 
sound board, 

Registers at call: Return Registers: 

SI = 0007h AX = 0000h melodic 


000 1h percussive 
Conflicts: See chapter 1. 
See Also: Function 0006h 


INTERRUPT 65h - Function 000Ch 


SET ACTIVE VOICE 

Purpose: Specify which of the sound board's voices is to be active. 

Available on: Systems equipped with an Ad Lib Restrictions: SOUND.COM must be installed. 
sound board, 

Registers at call: Return Registers: 

SI = 000Ch n/a 


ES:BX -> WORD voice (0000h to 0008h) 
Conflicts: See chapter |. 
See Also: Function 000Dh 


INTERRUPT 65h - Function 000Dh 


GET ACTIVE VOICE 

Purpose: Determine which of the sound board's voices is currently active. 

Available on: Systems equipped with an Ad Lib Restrictions: SOUND.COM must be installed. 
sound board, . 

Registers at call: Return Registers: 

SI = 000Dh AX = voice (0000h to 0008h) 


Conflicts: See chapter 1. 
See Also: Function 000Ch 


ANARKEY 
ANARKEY.COM is a commandline recall program by Steven Calwas. 


INTERRUPT 2Fh - Function Eh, Subfunction 00h 
INSTALLATION CHECK 


Purpose: Determine whether ANARKEY is installed, 
Available on: All machines. Restrictions: none. 
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Registers at call: Return Registers: 

AX = 5300h AL = 00h not installed 
FEh if installed but suspended (v3.0+) 
FFh installed 


Details: The default multiplex number is E3h, but it can be set to any value from COh to FFh. 
Conflicts: See chapter 1. 


INTERRUPT 2Fh - Function E3h, Subfunction 01h 


GET Unknown Data 
Purpose: uaknown. 
Available on: All machines. Restrictions: ANARKEY.COM version 2.0 or higher 
must be installed. 
Registers at call: Return Registers: 
AX =E301h DX:BX -> unknown. 
Conflicts: See chapter 1. 
Table 36-3. Format of Returned Data Structure for ANARKEY v2.0: 
Offset Size Description 
7 7 BYTEs _ signature (ANARKEY') 
00h WORD unknown (0001h in v2.0) 
02h WORD unknown (0001h in v2.0) 
04h WORD unknown (0000h in v2.0) 
06h WORD PSP segment of next program loaded 
Table 36-4, Format of Returned Data Structure for ANARKEY v3.0: 
Offset Size Description 
-1 BYTE multiplex number 
00h WORD unknown (0001h in v3.0) 
02h WORD unknown (0001h in v3.0) 
04h BYTE unknown (0000h in v3.0) 
05h WORD PSP segment of next program loaded 
INTERRUPT 2Fh - Function E3h, Subfunction 02h 
Unknown Function 
Purpose: unknown. 
Available on: All machines. Restrictions: ANARKEY.COM version 3.0 or higher 
must be installed. 
Registers at call: Return Registers: unknown. 
AX = E302h 
BL = unknown. 
Conflicts: See chapter 1, 
INTERRUPT 2Fh - Function E3h, Subfunction 03h 
ANARKMD API 
Purpose: Perform the functions available to the user through the ANARKMD program. 
Available on: All machines, Restrictions: ANARKEY,.COM version 3.0 or higher 
must be installed. 
Registers at call: Return Registers: unknown. 
AX = E303h 
BL = function 
Olhtoggle insert mode 


O2hdisplay contents of history buffer 


| 
\ 
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03h write history buffer to file 
ES:DX -> file name 
O4h clear history buffer 
OShundefine all aliases 
O6h show aliases 
O7hlist programs using Unix switchar 
O8hjump to bottom of history buffer 
---v4.0 
O9hadd string to history buffer 
ES:DI -> ASCIZ string 
OAh — unknown. 
ES:DI -> unknown code or data. 
OBh copy string to edit buffer for use as 
next input line, 
ES:DI -> ASCIZ string 
OCh = unknown. 
ODh = unknown copying operation 
OEh = unknown. 
OFhunknown. 
1Ohset unknown flag 
I Lhdisplay error message about running in 
EMS under MS Windows. 
Conflicts: See chapter |. 


INTERRUPT 2Fh - Function E3h, Subfunction 04h 


Unknown Function 

Purpose: unknown. 

Available on: All machines. Restrictions: ANARKEY.COM version 2.0 or higher 
must be installed. 

Registers at call: Return Registers: unknown. 

AX = E304h 


BL = unknown. 
Conflicts: See chapter t. 


INTERRUPT 2Fh - Function E3h, Subfunction 05h 
SUSPEND/ENABLE ANARKEY 


Purpose: Specify whether ANARKEY is to be active and provide commandline recall/editing. 


Available on: All machines. Restrictions: ANARKEY.COM version 3.0 or higher 
must be installed. 
Registers at call: Return Registers: n/a 
AX = B305h 
BL = 01h suspend 
00h enable 


Conflicts: See chapter |. 
See Also: Function E3h Subfunction 00h 


INTERRUPT 2Fh - Function E3h, Subfunction 06h 


Unknown Function 

Purpose: unknown, 

Available on: All machines. Restrictions: ANARKEY.COM version 4.0 must be 
installed. 

Registers at call: Return Registers: unknown. 


AX = E306h 
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Conflicts: See chapter 1. 
See Also: Function E3h Subfunction 00h 


INTERRUPT 2Fh - Function E3h, Subfunction 07h 


Unknown Function 

Purpose: unknown. 

Available on: All machines. Restrictions; ANARKEY.COM version 4.0 must be 
installed. 

Registers at call: Return Registers: 

AX = E307h AX = unknown. 


BL = unknown. 
Conflicts: See chapter 1. 
See Also: Function E3h Subfunction 00h 


AutoCAD 


INTERRUPT 7Ah 

AutoCAD Device Interface 

Purpose: Communication between AutoCAD and its device drivers. 

Available on: All machines. Restrictions: Must be running AutoCAD. 

Registers at call: unknown. Return Registers: unknown. 

Conflicts: Novell NetWare Low-level API (chapter 20), IBM 3270 Workstation Program API (chapter 26), Topware 
Network Operating System (chapter 27). 


AVATAR.SYS 
AVATAR.SYS is a CON replacement by George Adam Stanislav which interprets AVATAR command codes in the 
same way that ANSI.SYS interprets ANSI command codes. 


INTERRUPT 2Fh - Function 1Ah, Subfunction 00h 


INSTALLATION CHECK 
Purpose: Determine whether AVATAR.SYS is installed, 
Available on: All machines, Restrictions: none. 
Registers at call: Return Registers: 
AX = 1A00h AL = FFh if installed : 
BX = 4156h (‘AV') CF clear 
CX = 4154h (‘AT’) BX = AVATAR protocol level supported 
DX = 4152h (‘AR') CX = driver type: 

0000h AVATAR.SYS 

4456h DVAVATAR.COM inside a DESQview 

window 
DX =0016h 


Details: AVATAR also identifies itself as ANSILSYS if BX, CX, or DX differ from the magic values, 
Conflicts: DOS 4+ ANSI.SYS (chapter 8). 


INTERRUPT 2Fh - Function 1Ah, Subfunction 21h 
SET DRIVER STATE 


Purpose: Specify whether AVATAR.SYS is to be active, what type of screen output to perform, and whether to 
translate the gray plus and minus keys. 
Available on: All machines. Restrictions: AVATAR.SYS must be installed. 





i 
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Registers at call: Return Registers: 
AX = 1A21h (AL="!') CF set on error (invalid subfunction) 
DS:SI -> command string with one or more state CF clear if successful 


characters (Table 36-5) 
CX = length of command string 
Details: The characters in the state string are interpreted left to right, and need not be in any particular order. 
Conflicts: None known, 
See Also: Function 1Ah Subfunction 3Fh 


Table 36-5. Values of State Characters: 


Value Meaning 

‘a’ activate driver 

‘d disable driver 

'f use fast screen output 

always convert gray keys (+ and -) to function keys 
GC never convert gray keys 

T convert gray keys only when ScrollLock active 

use slow screen output 

t Tandy 1000 keyboard (not yet implemented) 


INTERRUPT 2Fh - Function 1Ah, Subfunction 3Ch 
Unknown Function 


Purpose: unknown. 

Available on: All machines. Restrictions: AVATAR.SYS version 0.11 must be 
installed. 

Registers at call: Return Registers: 

AX = 1A3Ch CX = 0000h 

unknown, 

Conflicts: None known. 


INTERRUPT 2Fh - Function 1Ah, Subfunction 3Eh 
Unknown Function 


Purpose: unknown. 

Available on: All machines. Restrictions; AVATAR.SYS version 0.11 must be 
installed. 

Registers at call: Return Registers: 

AX = 1A3Eh CL = unknown. 

CL = unknown. CH = unknown, 

CH = unknown. DL = unknown. 

DL = unknown. DH = unknown. 

DH = unknown. 

Conflicts: None known, 


INTERRUPT 2Fh - Function 1Ah, Subfunction 3Fh 
QUERY DRIVER STATE 


Purpose: Determine whether AVATAR.SYS is active, which type of screen output it is performing, and whether it 
is translating the gray plus and minus keys. 


Available on: All machines. Restrictions; AVATAR.SYS must be installed. 
Registers at call: Return Registers: 

AX = 1A3Fh (AL="?') CF clear 

ES:DI -> buffer CX = actual size of returned info 


CX = length of buffer in bytes 
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Details: The retumed information consists of multiple letters whose meanings are described under Function 1Ah 
Subfunction 21h. 

Conflicts: None known, 

See Also: Function 1Ah Subfunction 21h 


INTERRUPT 2Fh - Function 1Ah, Subfunction 44h 


GET DATA SEGMENT 

Purpose: Called by AVATAR.SYS whenever it is invoked in order to determine where to store its data, 

Available on: All machines. Restrictions: AVATAR.SYS version 0.11 or higher 
must be installed. 

Registers at call: Return Registers: 

AX = 1A44h AX = 0000h 

BX =4156h (AV) DS = data segment 


CX = size of data segment 
Details: If each process under a multitasker hooks this function and provides a separate data segment, 
AVATAR.SYS becomes fully reentrant, 
Conflicts: None known. 
See Also: Function 1Ah Subfunctions 21h and 3Fh 


INTERRUPT 2Fh - Function 1Ah, Subfunction 52h 


GET Unknown Data 

Purpose: unknown. 

Available on: All machines, Restrictions; AVATAR.SYS version 0.11 must be 
installed, 

Registers at call: Return Registers: 

AX = 1A52h unknown data copied into user buffer 

CX = size of buffer 





ES:DI -> buffer 

Details: The maximum size of the data which may be copied is returned by Function 1Ah Subfunction 72h. 
Conflicts: None known. 

See Also: Function 1Ah Subfunction 72h 


INTERRUPT 2Fh - Function 1Ah, Subfunction 53h 


Unknown Function 

Purpose: unknown. 

Available on: All machines. Restrictions: AVATAR.SYS version 0.11 must be 
installed, 

Registers at call: Return Registers: unknown. 

AX = LA53h 

CL = unknown, (00h-05h) 

unknown, 

Conflicts: None known. 

INTERRUPT 2Fh - Function 1Ah, Subfunction 72h 

GET Unknown SIZE 

Purpose: Determine the maximum size of the data which may be returned by Subfunction 52h. 

Available on: All machines. Restrictions: AVATAR.SYS version 0.11 must be 
installed. 

Registers at call: Return Registers: 

AX = LA72h CX = maximum size of unknown data 


Conflicts: None known. 
See Also: Function 1Ah Subfunction 52h 
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INTERRUPT 2Fh - Function 1Ah, Subfunction 7Bh 


Unknown Function 
Purpose: unknown. 
Available on: All machines. Restrictions; AVATAR.SYS version 0.11 must be 
installed. 
Registers at call: Return Registers: 
AX = 1A7Bh AX = 0000h 
CX = 0000h 
Conflicts: None known. 
INTERRUPT 2Fh - Function 1Ah, Subfunction 7Dh 
Unknown Function 
Purpose: unknown, 
Available on: All machines. Restrictions: AVATAR.SYS version 0.11 must be 
installed. 
Registers at call: Return Registers: 
AX = 1A7Dh AX = unknown. 
INTERRUPT 2Fh - Function 1Ah, Subfunction ADh 
Unknown Function 
Purpose: unknown, 
Available on: All machines. Restrictions; AVATAR.SYS version 0.11 must be 
installed. 
Registers at call: Return Registers: 
AX=1AADh AX = 0000h if DX was nonzero 
DX = 0000h unknown. 
CX = subfunction (00h-OCh) 
unknown. 
Conflicts: None known, 
INTERRUPT 79h 
FAST GET KEYSTROKE 
Purpose: Retrieve the next keystroke from the keyboard buffer, if available. 
Available on: All machines. Restrictions: AVATAR.SYS must be installed, 
Registers at call: n/a Return Registers: 
CF set if no keystroke available 
AX = FFFFh 
CF clear if key pressed 


AX = keystroke 
Details: If a keystroke is available, it is removed from the keyboard buffer before being returned. 
Conflicts: None known. 
See Also: INT 29h 


BMB Compuscience Canada Utilities 
BMB Compuscience Canada produces a number of utilities which all use the common installation check described 
here, 


INTERRUPT 2Fh 
INSTALLATION CHECK 


Purpose: Determine whether one of the BMB Compuscience Canada utilities or another program using the same 
interface is installed. 
Available on: All machines. Restrictions: none. 
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Registers at call: Return Registers: 

AH = xx (dynamically assigned based upon a search AL = 00h not installed 
for a multiplex number which doesn’t answer Oth not installed, not OK to install 
installed) FFh installed 


AL = 00h install check 

ES:D] = EBEBh:BEBEh 

Details: If ES:DI was EBEBh:BEBEh on entry, ES:DI will point to a string of the form 
"MMMMPPPPPPPPVNNNN' where MMMM is a short form of the manufacturer's name, PPPPPPPP is a product 
name and NNNN is the product's version number. : 


Btrieve 
Btrieve is a record management system originally produced by SoftCraft but now published and maintained by 
Novell, One of the most widely used record managers, it offers automatic record locking for network support, and 
pre- and post-imaging to preserve data integrity in case of power failure. Though often called a database manager, 
Btrieve does not maintain field information within the data files as do most database management systems, nor does 
it even distinguish between "fields" within a record. Thus the same records may be viewed in quite different ways by 
different programs. 

In single-user environments, Btrieve requires that its TSR be loaded; in network environments, the TSR may be 
loaded at each workstation, or a special BREQUEST server may be invoked, 


INTERRUPT 7Bh 

Btrieve API 

Purpose: Open, access, modify, and close data files using Btrieve record manager. 

Available on: All machines. Restrictions: BTRIEVE’s TSR, or network 
BREQUEST, must be active. 

Registers at call: Return Registers: 

DS:DX -> 38-byte parameter record (Table 36-6) return code field set 


Details: Btrieve sets low byte of vector to 33h; this serves as the installation check, 
Conflicts: Eicon Access API (chapter 26). 


Table 36-6. Format of Btrieve Parameter Record: 


Offset Size Description 

00h DWORD pointer to data buffer 

04h WORD data buffer length 

O6h DWORD pointer to 90-byte record containing positioning info (should be the same for all calls for 

the same file) 

QAh DWORD pointer to 38-byte FCB info buffer (should be same for all calls for same file) 
OEh WORD function code (Table 36-7) 

10h DWORD _ pointer to file name/key buffer 

14h BYTE key length 

15h BYTE key number 

16h DWORD pointer to status code (Table 36-8) 

1Ah WORD interface code (version specific) 
Table 36-7. Values for Btrieve function code: 

Value Function Value Function 
00h open 08h get_greater 
Olh close 09h get_gr_eql 
02h insert OAh get_less 
03h update OBh get_less_eq 
04h delete O0Ch get_first 
05h get_equal ODh get_last 
06h get_next OEh create 


07h get_prev OFh stat 





Table 36-7. Values for Btrieve function code (continued) 





Value Function 
Oh extend 
ih set_dir: set directory information 
12h get_dir: get directory information 
13h begin_trans 
14h end_trans 
5h abort_trans 
6h get_ pos: get record position number 
Th get_direct: get data by sending record 
position 
18h step, direct 
9h stop 
Ah version 
Bh unlock 
1Ch reset 
{Dh set owner 





Value 
1Eh 
1Fh 
20h. 
21h 
22h 
23h 
3th 
37h 
38h 
39h 
3Ah 
3Bh 
3Ch 
3Dh 
3Eh 
3Fh 
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Function 

clear owner 

create supplemental index 
drop supplemental index 
step first 

step last 

step next 

unknown. 

unknown. 

unknown, 

unknown. 

unknown. 

unknown. 

unknown. 

unknown. 

unknown. 

unknown. 


Add 100 (64h) for a single-record wait lock (automatically released on next get) 

Add 200 (C8h) for a single-record nowait lock (returns error 54h or 55h if the record is already locked) 
Add 300 (12Ch) for a multiple-record wait lock (not released until unlock called) 

Add 400 (190h) for a multiple-record nowait lock (returns error 54h or 55h if the record is already locked) 


Table 36-8. Values for Status Code: 


Value Function 

00h successful 

Olh invalid operation 
02h Y/O error 

03h file not open 

04h key value not found 
05h duplicate key value 
06h invalid key number 
07h different key number 
08h invalid positioning 
09h end of file 

OAh modifiable key value error 
OBh invalid file name 
0Ch file not found 

ODh extended file error 
OEh pre-image open error 
OFh pre-image I/O error 
10h expansion error 

1th close error 

12h disk full 

13h unrecoverable error 
14h record manager inactive 
{5h key buffer too short 
16h data buffer lengthoverrun 
17h position block length 
18h page size error 

19h create I/O error 

1Ah number of keys 

1Bh invalid key position 
1Ch invalid record length 
IDh invalid key length 
1Eh not a Btrieve file 


1Fh file already extended 


Value 
20h 
22h 
23h 
24h 
25h. 
26h 
27h 
28h 
29h 
2Ah 
2Bh 
2Ch 
2Dh 
2Eh 
2Fh 


31 
32] 
33h 
34h 
35h 
36h 





Function 

extended J/O error 

invalid extension name 
directory error 

transaction error 

transaction is active 

transaction control file I/O error 
end/abort transaction error 
transaction max files 

operation not allowed 
incomplete accelerated access 
invalid record address 

null key path 

inconsistent key flags 

access to file denied 

maximum open files 

invalid alternate sequence 
definition 
key type error 
owner already set 
invalid owner 
error writing cache 
invalid interface 
variable page error 
autoincrement error 
incomplete index 
expanded memory error 
compression buffer too short 
file already exists 

conflict 

lock error 

lost position 

read outside transaction 
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Table 36-8, Values for Status Code (continued) 


Value Function Value Function 

54h record in use 57h handle table full 

55h file in use 58h incompatible open mode 

56h file table fuil S5Dh incompatible lock type 
SEh permission error 

CED (Command Editor) 


CED is a shareware DOS command-line enhancer by Christopher J. Dunford; its follow-on is the commercial 
product PCED. One feature which CED adds is the ability to install user-provided commands, which will be treated 
as “internal commands" by CED, DOS 3.3 and higher provide an equivalent capability in COMMAND,COM; see 
INT 2Fh Function AEh in chapter 8. 


INTERRUPT 21h - Function FFh, subfunction 00h 
ADD INSTALLABLE COMMAND 


Purpose: Store the name and handler for a new CED command. 


Available on: All machines. Restrictions: CED must be installed. 
Registers at call: Return Registers: 
AH = FFH CF clear if successful 
AL =00h CF set on error 
BL = mode AX = Oth invalid function 
bit 0 = 1 callable from DOS prompt O8h insufficient memory 
bit 1 = | callable from application OEh bad data 
DS:SI -> CR-terminated command name AH = FFh if CED not installed 


ES:DI -> FAR routine entry point 
Conflicts: None known. 
See Also: WCED Function 0Ah Subfunction 00h (below) 


INTERRUPT 21h - Function FFh, subfunction 01h 
REMOVE INSTALLABLE COMMAND 


Purpose: Erase the name and handler for the specified installed CED command. 


Available on: All machines. Restrictions: CED must be installed. 
Registers at call: Return Registers: 

AH = FFH CF clear if successful 

AL=0lh CF set on error 

DS:SI -> CR-terminated command name AX = Olh invalid function 


02h command not found 
AH = FFh if CED not installed 
Conflicts: None known. 
See Also: WCED Function 0Ah Subfunction 00h (below) 


INTERRUPT 21h - Function FFh, subfunction 02h 
RESERVED, MAY BE USED TO TEST FOR CED INSTALLATION 


Purpose: Determine whether CED is installed. 


Available on: Ali machines. Restrictions: none. 
Registers at call: Return Registers: 
AH = FFH CF clear if successful 
AL = 02h CF set on error 


AX = 01h invalid function 
AH = FFh if CED not installed 
Conflicts: None known. 
See Also: WCED Function 0Ah Subfunction 00h (below) 
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CP/M-86 

Digital Research's CP/M-86 was one of the three operating systems originally offered by IBM for its PC, Although it 
never gained much popularity, its descendant DR-DOS is currently selling fairly successfully. Unlike DR-DOS, 
however, CP/M-86 is entirely incompatible with MS-DOS. 


INTERRUPT E0h 

CP/M-86 function calls 

Purpose: Request operating system functions. 

Available on: Machines running CP/M-86. Restrictions: none. 

Conflicts: BASIC interpreter (chapter 1), APL*PLUS/PC (chapter 31), "Micro-128" virus (chapter 34). 


Disk Spool Il 

Disk Spool Il by Budget Software Company is a disk-based print spooler. When an application produces printer 
output, that output is captured and stored on disk; as the printer becomes ready for more output, previously-stored 
data is retrieved from the disk and sent to the printer. 


INTERRUPT 1Ah - Function AOh 


INSTALLATION CHECK 

Purpose: Determine whether Disk Spool II (version unknown) is installed. 
Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AH = AOh AH = BOh 


ES = code segment 
BX -> name of current spool file 
SI -> current despool file 
CL = 00h despooler is disabled 
41h despooler is enabled 
CH = 00h spooler is disabled 
41h spooler is enabled 
DL = 00h despooler is currently active printing a file 
41h despooler is standing by 
Conflicts: None known. 
See Also: Function DOh 


INTERRUPT 1Ah - Function ABh 


INSTALLATION CHECK 

Purpose: Determine whether Disk Spool II version 1.83 is installed. 

Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AH = ABh ES = code segment 


BX -> name of current spool file 
SI -> current despool file 
CL = unknown. 
CH = unknown. 
DL = unknown. 
DH = 00h unknown. 
= 41h unknown, 
AL = unknown. 
AH = BAh 
DI = 0000h unknown. 
000th wiknown, 
Conflicts: None known. 
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See Also: Functions ACh and ADh 


INTERRUPT 1Ah - Function ACh 
INSTALLATION CHECK 


Purpose: Determine whether Disk Spool II version 1.83 is installed. 


Available on: All machines. 
Registers at call: 
AH=ACh 


Details: This function is identical to Function ABh. 


Conflicts: None known. 
See Also: Functions ABh and ADh 


INTERRUPT 1Ah - Function ADh 
Disk Spool FUNCTION CALLS 


Purpose: Control the print spooler. 
Available on: All machines. 


Registers at call: 
AH = ADh 
AL = function code 
02h enable spooler only 
03h enable the despooler 
04h disable the despooler 
O8h inhibit popup menu 
09h enable popup menu 
OAh unknown, 
OBh disable the spooler 
0Ch unknown, 
ODh unknown. 
OEh pop up the menu 
OFh unknown, 
11h unknown. 
14h unknown, 
15h unknown, 
16h unknown. 
17h unknown. 
18h unknown. 
19h unknown. 
20h unknown. 
21h unknown. 
22h unknown. 
23h unknown. 
30h unknown. 
Conflicts: None known. 
See Also: Function ABh 


INTERRUPT 1Ah - Function DOh 
Disk Spool FUNCTION CALLS 
Purpose: Control the print spooler. 
Available on: All machines, 


Registers at call: 
AH=D0h 


Restrictions: none. 
Return Registers: 
(see Function ABh) 


Restrictions; Disk Spool II version 1,83 must be 
installed. 

Return Registers: 

AH = 00h if successful 


Restrictions: Disk Spool II (unknown version) must be 
installed. 
Return Registers: n/a 
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AL = function code 
Olh enable spooler and despooler 
02h enable spooler only 
03h enable despooler at beginning of file 
04h disable the despooler 
05h disable the despooler and spooler 
06h clear the spool file 
08h inhibit the popup menu 
09h enable the popup menu 
OBh disable the spooler 
OCh start despooler after last successfully 
printed document 
ODh start despooler at the exact point where it 
last left off 
OEh pop up the menu 
20h clear file pointed to by the despooler 
Conflicts: None known, 
See Also: Function AOh 


DOSED 
DOSED is a free DOS commandline editor/history buffer by Sverre H. Huseby. 


INTERRUPT 21h - Function FFh 
INSTALLATION CHECK 


Purpose: Determine whether DOSED is present. 

Available on: All machines. Restrictions: none. 

Registers at call: Return Registers: 

AH = FFh ES:DI -> "DOSED" if installed 
DS:SI -> "DOSED" 

ES = 0000h 


Conflicts; CED (see above), DJ GO32.EXE DOS extender (chapter 9), Topware Network Operating System 


(chapter 27), "Sunday", "PSQR/1720", and “Ontario" viruses (chapter 34). 
ELRES 


ELRES is an MSDOS return code (errorlevel) recorder by David H. Bennett which stores recent errorlevel values, 


allows them to be retrieved for use in batch files, and can place them in an environment variable, 


INTERRUPT 21h - Function 2Bh 
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INSTALLATION CHECK 

Purpose: Determine whether ELRES version 1.1 or higher is present. 

Available on: All machines. Restrictions: none. 

Registers at call: Return Registers: 

AH = 2Bh ES:BX -> ELRES history structure (Table 36-9) 
CX = 454Ch (‘EL’) DX = DABEh (signature, DAve BEnnett) 


DX = 5253h (‘RS') 


Conflicts: PC Tools v5.1 PC-CACHE (chapter 6), DOS 1+ Set System Date (chapter 8), DESQview (chapter 15), 


peANY WHERE IV (chapter 28), TAME (chapter 36). 
See Also: Function 4Bh, DOS Function 4Dh (chapter 8) 


Table 36-9, Format of ELRES History Structure: 
Offset Size Description 


00h WORD number of return codes which can be stored by following buffer 
02h WORD current position in buffer (treated as a ring) 
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Table 36-9. Format of ELRES History Structure (continued) 


Offset Size Description 

04h NBYTEs ELRES buffer 

INTERRUPT 21h - Function 4Bh 

INSTALLATION CHECK 

Purpose: Determine whether ELRES version 1.0 is present. 

Available on: All machines. Restrictions: none. 

Registers at call: Return Registers: 

AH =4Bh ES:BX -> ELRES history structure (see Function 2Bh 
DS:DX = 0000h:0000h above) 


DX = DABEh (signature, DAve BEnnett) 
Conflicts: DOS 2+ "EXEC" (chapter 8), various viruses (chapter 34), F-DRIVER.SYS (chapter 34). 
See Also: Function 2Bh (above) 


Extended Batch Language 


Extended Batch Language is a batch-file enhancer by Seaware. 


INTERRUPT 64h - Functions 00h to 6Ch 


UNUSED 
Purpose: These functions are not used by EBL. 
Available on: All machines, Restrictions: EBL must be installed. 
Registers at call: Return Registers: 
AH = function unchanged for functions 60h to 6Ch 
00h to 5SFh chained to previous handler as returned by previous handler otherwise 


60h to 6Ch reserved, return immediately 
Details: The chaining code does not check whether the interrupt had been hooked before, so attempting to chain 
when the previous vector was 0000h:0000h will crash the system. 
Conflicts: None known, 


INTERRUPT 64h - Function 6Dh 


INSERT TONE IN QUEUE 

Purpose: Specify a sound to be played as soon as the currently-stored notes have been played. 

Available on: All machines. Restrictions: EBL version 4.01 or higher must be 
installed. 

Registers at call: Return Registers: 

AH = 6Dh AL = 00h if note stored 

AL = unknown. O1h if no room to store 

CX = frequency in Hertz 

DL = duration in clock ticks 

Conflicts: See Table 1-3 in chapter 1. 

INTERRUPT 64h - Function 6Eh 

CLEAR Unknown COUNTER/FLAG 

Purpose: Reset an unknown state. 

Available on: All machines. Restrictions: EBL version 3.14 or higher must be 
installed. 

Registers at call: Return Registers: n/a 


AH = 6Eh 
Conflicts: See Table 1-3 in chapter |. 


INTERRUPT 64h - Function 6Fh 


RETURN COUNTER/FLAG Function 6Eh CLEARS 


Purpose: Determine unknown state. 
Available on: All machines. 
Registers at call: 

AH = 6Fh 


Conflicts: See Table 1-3 in chapter 1. 


INTERRUPT 64h - Function 70h 
Unknown Funetion 

Purpose: unknown. 

Available on: All machines. 
Registers at call: 

AH = 70h 

AL = unknown, 


Conflicts: See Table 1-3 in chapter 1. 


INTERRUPT 64h - Function 71h 
Unknown Function 


Purpose: unknown. 
Available on: All machines. 
Registers at call: 

AH=71h 

AL = unknown. 


Conflicts: See Table 1-3 in chapter 1. 


INTERRUPT 64h - Function 72h 
Unknown Function 

Purpose: unknown. 

Available on: All machines. 
Registers at call: 

AH = 72h 


Details: Functions 72h and 7Ah-7Dh appear to be interfaces to the optional fioating-point and extended function 


packages. 


Conflicts: See Table 1-3 in chapter 1. 


INTERRUPT 64h - Function 73h 


INSERT BYTE AT END OF KEYBOARD BUFFER 
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Restrictions: EBL must be installed. 


Return Registers: 
unknown. -> counter/flag 


Restrictions: EBL must be installed. 


Return Registers: unknown. 


Restrictions: EBL must be installed. 


Return Registers: unknown. 


Restrictions: EBL must be installed. 


Return Registers: unknown. 


Purpose: Store a character which will be retrieved when reading the keyboard at a later time. 


Available on: All machines. 
Registers at call: 

AH = 73h 

AL = byte to insert 


Restrictions: EBL must be installed. 


Return Registers: 
AL = 00h if byte inserted 
Olh if no room to store 


Conflicts: See Table 1-3 in chapter 1. 


INTERRUPT 64h - Function 74h 
INSERT BYTE AT FRONT OF KEYBOARD BUFFER 


Purpose: Store a character which will be retrieved the next time the keyboard is read. 
Available on: All machines. 


Restrictions: EBL must be installed. 


i 
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Registers at call: 

AH = 74h 

AL = byte to insert 

Conflicts: See Table 1-3 in chapter 1. 


INTERRUPT 64h - Function 75h 


Unknown Function 


Purpose: unknown. 

Available on: All machines. 
Registers at call: 

AH = 75h 

Conflicts: See Table 1-3 in chapter 1. 


INTERRUPT 64h - Function 76h 
GET KEYBOARD "STACK" STATUS 


Return Registers: 
AL = 00h if byte inserted 
Oih if no room to store 


Restrictions: EBL must be installed. 
Return Registers: unknown. 


Purpose: Determine whether the next keyboard read will actually read the keyboard or the internal EBL buffer. 


Available on: All machines. 
Registers at call: 
AH = 76h 


Conflicts: See Table 1-3 in chapter 1. 


INTERRUPT 64h - Function 77h 
CLEAR INTERNAL KEYBOARD BUFFER 


Restrictions: EBL must be installed, 
Return Registers: 
AL ='R' if kbd read will read physical keyboard 
‘S' if it will read EBL internal keyboard buffer 
AH = unknown, 


Purpose: Discard all stored keystrokes which have not yet been read by an application. 


Available on: All machines. 
Registers at call: 

AH=77h 

Conflicts: See Table 1-3 in chapter 1. 


INTERRUPT 64h « Function 78h 
Unknown Function 


Purpose: unknown, 

Available on: All machines. 
Registers at call: 

AH = 78h 

AL = unknown, 

Conflicts: See Table 1-3 in chapter 1. 


INTERRUPT 64h - Function 79h 


Unknown Function 

Purpose: unknown. 

Available on: All machines. 
Registers at call: 

AH=79h 

Conflicts: See Table 1-3 in chapter 1. 


INTERRUPT 64h - Function 7Ah through 7Dh 


Unknown Function 


Purpose: unknown, 
Available on: All machines. 


Restrictions; EBL must be installed. 
Return Registers: n/a 


Restrictions: EBL must be installed. 
Return Registers: unknown. 


Restrictions: EBL must be installed. 
Return Registers: unknown. 


Restrictions: EBL must be installed. 
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Registers at call: Return Registers: known. 


AH = 7Ah through 7Dh 


AL & unknown. ; 
Details: Functions 72h and 7Ah-7Dh appear to be interfaces to the optional floating-point and extended function 


packages. 
Conflicts: See Table 1-3 in chapter I. 


INTERRUPT 64h - Function 7Eh 


CLEAR Unknown BUFFER 

Purpose: wiknown. 

Available on: All machines. Restrictions: EBL version 3.14 or higher must be 
installed. 

Registers at call: Return Registers: n/a 

AH =7Eh 

Conflicts: See Table 1-3 in chapter 1. 

INTERRUPT 64h - Function 7Fh 

INSTALLATION CHECK 

Purpose: Determine whether EBL is installed. 

Available on: All machines. Restrictions: none. 

Registers at call: Return Registers: 

AH = 7Fh CX = version in BCD 


DI = segment of unknown. 
BX = segment of next program's PSP 
Conflicts: See Table 1-3 in chapter |. 


INTERRUPT 64h - Functions 80h to FFh 


UNUSED 

Purpose: These functions are not used by EBL and are chained to the previous handler. 
Available on: All machines. Restrictions: none. 

Registers at call: Return Registers: 

AH = 80h to FFh as returned by previous handler 


Details: The chaining code does not check whether the interrupt had been hooked before, so attempting to chain 
when the previous vector was 0000h:0000h will crash the system. 
Conflicts; None known. 


FAKEY.COM 
FAKEY is a keystroke faking utility by System Enhancement Associates. 


INTERRUPT 16h - Function 70h 


INSTALLATION CHECK 

Purpose: Determine whether FAKEY.COM is installed. 

Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 

AH = 70h AX = 1954h if installed 


Conflicts: None known. 


INTERRUPT 16h - Function 71h 
PUSH KEYSTROKES 


Purpose: Place keystrokes into the keyboard buffer as if the user had pressed the keys. 
Available on; All machines. Restrictions: FAKEY.COM must be installed. 
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Registers at call: Return Registers: n/a 
AH=71h 
CX = number of keystrokes 
DS:SI -> array of words containing keystrokes to be 
returned by INT 16h Function 00h (chapter 3) 
Conflicts: None known. 
See Also: Functions 05h and 72h 


INTERRUPT 16h - Function 72h 


CLEAR FAKED KEYSTROKES 

Purpose: Forget all keystrokes which were pushed but have not yet been read by the application. 

Available on: All machines, Restrictions: FAKEY.COM must be installed. 
Registers at call: Return Registers: n/a 

AH = 72h 


Conflicts: None known. 
See Also: Function 71h 


INTERRUPT 16h - Function 73h 


PLAY TONES 
u pose: Specify a series of musical notes to play on the system's speaker. 
‘ yailable on: All machines. Restrictions: FAKEY.COM must be installed. 
Registers at call: Return Registers: n/a 
AH=73h 


CX = number of tones to play 

DS:SI -> array of tones (Table 36-10) 

Conflicts: None known. 

See Also: TopView INT 15h Function 10h Subfunction 19h (chapter 15) 


Table 36-10. Format of Tone Array Entries: 


Offset Size Description 

00h WORD divisor for timer channel 2 
02h WORD duration in clock ticks 
FASTBUFF.COM 


FASTBUFF.COM is a keyboard speedup/screen blanking utility by David Steiner. 
INTERRUPT 10h - Function FAh 


INSTALLATION CHECK 

Purpose: Determine whether FASTBUFF.COM is installed. 

Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 

AH =FAh AX = OOFAh if installed 


ES = segment of resident code 
Conflicts: EGA Register Interface Library (chapter 5). 


FLASHUP.COM 
FLASHUP.COM is part of Flash-Up Windows by The Software Bottling Co. FLASHUP also hooks INT 10h and 
receives commands via INT 10h Functions 09h and OAh consisting of an 80h followed by the actual command. 


INTERRUPT 17h - Function 60h 
INSTALLATION CHECK 


Purpose: Determine whether FLASHUP.COM is installed. 
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Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AE = 60h AL = 60h 


DX = CS of resident code 


Conflicts: None known. 
See Also: INT 10h Functions 09h and OAh 


GEM 

Digital Research's GEM (Graphics Environment Manager) was one of the earliest graphical interfaces for the IBM 
PC, available long before the current craze began. While it was never a bestseller like Microsoft Windows 3.0 has 
been, particularly as an operating environment, it has enjoyed continuing success in vertical applications where it 
provides the user interface primitives. Ventura Publisher is one example of such a combination. 


INTERRUPT EFh - Function 0473h 


GEM INTERFACE 

Purpose: Communicate with the GEM environment. 

Available on: All machines. Restrictions: Must be running Digital Research's 
GEM. 

Registers at call: Return Registers: 

CX = 0473h varies by function 


DS:DX -> GEM parameter block 
Conflicts: BASIC Interpreter (chapter 1). 


GOLD.COM 
GOLD is a TSR by Bob Eager which makes the NumLock key return the code for F1; the purpose is to improve 


Kermit's VTxxx emulation, 


INTERRUPT 2Fh - Function DCh, Subfunction 00h 


INSTALLATION CHECK 

Purpose: Determine whether GOLD is installed. 

Available on: All machines. Restrictions: none, 
Registers at call: Return Registers: 
AX = DCOOh AL = 00h not installed 


FFh installed 
Conflicts: None known. 


INTERRUPT 2Fh - Function DCh, Subfunction 01h 


GET STATE 
Purpose: Determine whether GOLD is currently translating the NumLock key. 
Available on: All machines. Restrictions: GOLD must be installed. 
Registers at call: Return Registers: 
AX =DCO0Ih AL = status 
00h off 
Olh on 


Conflicts: None known. 
See Also: Function DCh Subfunctions 00h and 02h 


INTERRUPT 2Fh - Function DCh, Subfunction 02h 
SET STATE 


Purpose: Specify whether GOLD should translate the NumLock key into F1. 
Available on: All machines. Restrictions: GOLD must be installed. 
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Registers at call: Return Registers: 
AX =DCO02h AL = 00h (OK) 
DL = new state 

00h off 

Oth on 


Conflicts: None known. 
See Also: Function DCh Subfunction 01h 


The IBM Digitized Sound Package 
The IBM Digitized Sound Package was written by John W. Ratcliff. 


INTERRUPT 66h - Function 06h, Subfunctions 88h and 89h 


Unknown Functions 

Purpose: unknown, 

Available on: All machines. Restrictions: The IBM Digitized Sound Package must 
be installed. 

Registers at call: Return Registers: unknown. 

AX = 0688h or 0689h 

unknown. 

Conflicts; Data General DG10 (chapter 1), MicroHelp Stay-Res Plus. 

InnerMission 

InnerMission is a shareware graphical screen blanker by Kevin Stokes. 

INTERRUPT 2Fh - Function 93h 

INSTALLATION CHECK 

Purpose: Determine whether InnerMission version 1.7 or higher is installed. 

Available on: All machines. Restrictions: none. 

Registers at call: Return Registers: 

AH = 93h AL = FFh if installed and BXx=CX=AX on entry 

BX = CX = AX BX = segment of resident code 


O1h if installed but BX or CX differ from AX 
Conflicts: None known, 


INSET 


INSET is a text/graphics integration program for printers. 


INTERRUPT 17h - Function 02h, Subfunction 07C3h 


INSTALLATION CHECK 

Purpose: Determine whether INSET is installed. 

Available on: All machines. Restrictions: none. 

Registers at call: Return Registers: 

AH = 02h CX = 07C2h (19864) if installed 
DX = 0000h 


CX = 07C3h (1987d) 
Conflicts: None known. 


INTERRUPT 17h - Function CDh, Subfunction 00h 


EXECUTE COMMAND STRING 


Purpose: Perform one or more commands as though typed by the user. 
Available on: All machines, Restrictions: INSET must be installed. 
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Registers at call: Return Registers: 
AX =CD00h CX = 07C2h (1986d) 


DS:DX -> ASCIZ command string (max 80 bytes) 
Details: The user interface menus pop up after the last command unless that command exits INSET. 


Conflicts: None known. 


INTERRUPT 17h - Function CDh, Subfunction 01h 


GET IMAGE SIZE 

Purpose: Determine the width and height of the specified image. 

Available on: All machines. Restrictions: INSET must be installed. 
Registers at call: Return Registers: 

AX =CDOIh AX = height in 1/720th inch 

DS:DX -> ASCIZ name of image file BX = width in 1/720th inch 


CX = 07C2h (1986d) 
Conflicts: None known. 


INTERRUPT 17h - Function CDh, Subfunction 02h 


INITIALIZE 

Purpose: Prepare INSET for operation. 

Available on: All machines. Restrictions: INSET must be installed. 
Registers at call: Return Registers: 

AX = CD02h CX = 07C2h (1986d) 


Details: This call closes all open files and resets the printer. 
Conflicts: None known. 
See Also: Function CDh Subfunction 04h 


INTERRUPT 17h - Function CDh, Subfunction 03h 
EXECUTE INSET MENU WITHIN OVERRIDE MODE 


Purpose: Perform the menu function in OVERRIDE entry mode. 


Available on: All machines. Restrictions: INSET must be installed. 
Registers at call: Return Registers: 
AX = CD03h CX = 07C2h (1986d) 


Conflicts: None known. 


INTERRUPT 17h - Function CDh, Subfunction 04h 


INITIALIZE LINKED MODE 

Purpose: Begin using an application function for the graphics output stream rather than INT 17h Functions 00h 
through 02h. 

Available on: All machines. Restrictions: INSET must be installed. 

Registers at call: Return Registers: 

AX = CD04h CX =07C2h 


ES:SI -> FAR routine for linked mode 
Details: Use the linked-mode routine as follows: 


Calling Sequence: Return Code for Linked-mode Routine: 
AL = 00h send character in BL to printer AX = 0000h success 
AL=0lh_ send CX bytes from DS:DX to printer 0001h failure 


AL =02h move print head to horizontal starting 
position of image 

Conflicts: None known. 

See Also: Function CDh Subfunctions 02h and 08h 
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INTERRUPT 17h - Function CDh, Subfunction 05h 
START MERGING IMAGE INTO TEXT 


Purpose: Prepare to include an image into the textual output to the printer. 


Available on: All machines. Restrictions: INSET must be installed. 

Registers at call: Return Registers: 

AX = CDOS5h AH = printer type 

DS:DX -> ASCIZ name of PIX file 00h page-oriented (multiple images may be placed 
CX = left margin of text in 1/720th inch side-by-side) 


Olh line-oriented (use Function CDh Subfunction 
OGh for vertical paper movement) 
CX = 07C2h (1986d) 
Conflicts: None known. 
See Also: Function CDh Subfunction 07h 


INTERRUPT 17h - Function CDh, Subfunction 06h 
GRAPHICS LINE FEED 


Purpose: Advance the paper sufficiently to make the next line of graphics abut the bottom of the current line; should 
be used instead of a line feed on line-oriented printers while merging in graphics. 


Available on: All machines. Restrictions: INSET must be installed. 
Registers at call: Return Registers: 
AX =CD06h AH = completion status 


00h image complete 
Olh image incomplete 
CX = 07C2h (1986d) 
Conflicts: None known. 
See Also: Function CDh Subfunction 09h 


INTERRUPT 17h - Function CDh, Subfunction 07h 
FLUSH GRAPHICS FROM MERGE BUFFER 


Purpose: Clear the contents of the merge buffer. 


Available on: All machines. Restrictions: INSET must be installed. 
Registers at call: Return Registers: 
AX =CDO07h CX =07C2h 


Conflicts: None known. 
See Also: Function CDh Subfunction 05h 


INTERRUPT 17h - Function CDh, Subfunction 08h 


CANCEL LINK MODE 

Purpose: Return to normal output via INT 17h Functions 00h through 02h rather than the application's link function. 
Available on: All machines, Restrictions: INSET must be installed. 

Registers at call: Return Registers: 

AX = CD08h CX = 07C2h 


Conflicts: None known. 
See Also: Function CDh Subfunction 04h 


INTERRUPT 17h - Function CDh, Subfunction 09h 


ALTER TEXT LINE SPACING 

Purpose: Specify the amount to advance the printer after the end of a line of text. 

Available on: All machines. Restrictions: INSET must be installed. 
Registers at call: Return Registers: 

AX =CDO09h CX = 07C2h 


CX = line spacing in 1/720th inch 
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Details: This function was not yet implemented as of late 1988; line spacing is fixed at 1/6 inch for versions which 
do not implement this call. 

Conflicts: None known. 

See Also: Function CDh Subfunction 06h 


INTERRUPT 17h - Function CDh, Subfunction 0Ah 


GET SETUP 

Purpose: Determine current configuration, 

Available on: All machines. Restrictions: INSET must be installed. 
Registers at call: Return Registers: 

AX =CDOAh CX = 07C2h 


DS:DX -> buffer for IN.SET data 
Conflicts: None known. 


INTERRUPT 17h - Function CDh, Subfunction OBh 
START GETTING SCALED IMAGE 


Purpose: Prepare to retrieve a graphical image for inclusion in the printer output. 


Available on: All machines, Restrictions: INSET must be installed. 
Registers at call: Return Registers: 

AX = CDOBh AX = status 

DS:SI -> ASCIZ pathname of .PIX file 0000h OK 

BX = number of bitplanes FFFFh error 


CX = number of rows in output bitmap 
DX = number of columns in output bitmap 
Details: The entire image is returned in strips by repeated calls to Function CDh Subfunction 0Ch. 


Conflicts: None known. 


INTERRUPT 17h - Function CDh, Subfunction 0Ch 


GET NEXT IMAGE STRIP 

Purpose: Retrieve the portion of the image corresponding to the next line on the printer, 

Available on: All machines. Restrictions: INSET must be installed. 
Registers at call: Return Registers: 

AX = CD0Ch AX = status 


0000h OK but not complete 
0001h OK and image complete 
FFFFh error 
DS:SI -> buffer (max 41x) for bit map strip 
CX = start row 
DX = number of rows 
BX = offset in bytes between bit planes 
Details: The returned buffer may be overwritten by subsequent calls. 
Conflicts: None known. 
See Also: Function CDh Subfunction OBh 


INTRSPY 
INTRSPY is a script-driven debugger included with the book Undocumented_DOS. It will hook the first available 


interrupt in the range 60h through 67h. 


INTERRUPT 60h 

INTRSPY/CMDSPY API 

Purpose: Determine whether INTRSPY is installed, and if so, retrieve the address of the routine to call for 
communicating with INTRSPY. 

Available on: All machines. Restrictions: none. 
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Registers at call: n/a Return Registers: preserved. 

Details: The installation check is to (a) determine that the handler is an IRET instruction, then (b) determine that the 
signature 0Dh "INTRSPY vN.NN" immediately precedes the handler. If INTRSPY is installed, the DWORD 
immediately after the IRET stores its entry point. 


Call INTRSPY entry point with: Return Registers: 
AH = function: AH=00h 
AL = status 


00h successful 
Olh invalid function 
02h unknown. 
03h unknown, 
04h unknown. 
05h unknown. 
00h unknown. 
Oth set current directory (for use in reporting) 
ES:DI -> counted string containing directory 
name (max 79 char) 
02h set name of script file 
ES:DI -> counted string containing file name 
(max 79 chars) 
03h set script arguments 
ES:DI -> counted string containing arguments 
(max 79 chars) 
04h get directory set with function O1h 
ES:DI -> 80-byte buffer for directory name 
05h get name of script file 
ES:DI -> 80-byte buffer for script filename 
06h get script arguments 
ES:DI -> 80-byte buffer for script arguments 
O7h get unknown. 
CL = 00h-15h specifies what to get 
ES:DI -> WORD to be set with desired value 
on return 
08h get unknown, 
ES:DI -> WORD to be set with returned value 
09h get unknown. 
ES:DI -> WORD to be set with returned value 
OBh store code for interrupt handler 
ES:DI -> data 
CX = number of bytes 
OCh unknown. 
ES:DI -> unknown. 
ODh get unknown. 
ES:DI -> BYTE to be set with returned value 
OEh set unknown flag 
OFh clear unknown flag 


10h unknown. AL = 04h or O5h if failed 





11h unknown, AL = 05h if failed 


12h get unknown, CX = number of bytes returned in buffer 
ES:DI -> buffer 


13h unknown, 
Conflicts: See chapter 1. 





Miscellaneous APIs 36-29 


Jetstream 
The NorthNet Jetstream is a high-performance DMA-driven parallel card able to drive printers at up to 80000 


characters per second 


INTERRUPT 17h - Function FOh 


INSTALLATION CHECK 

Purpose: Determine whether Jetstream is installed. 

Available on: All machines. Restrictions: none. 

Registers at call: Return Registers: 

AH = Foh AX=0001h — Jetstream present 
DX = printer port (0-3) else non-Jetstream port 


Conflicts: None known, 


INTERRUPT 17h - Function F1h 


PRINT DATA BUFFER 

Purpose: Transmit the contents of the specified buffer to the printer. 

Available on: All machines. Restrictions: NorthNet Jetstream must be installed. 
Registers at call: Return Registers: 

AH=Fih AX = status 

CX = data buffer length 0000h printer not ready (see also INT 17h 

DX = printer port (0-3) Function 02h, chapter 3) 

DS:SI -> data buffer other printing started 


Conflicts: None known, 
See Also: Functions F2h, F3h, and FSh 


INTERRUPT 17h - Function F2h 
GET PRINT PROGRESS STATUS 


Purpose: Determine how much data remains to be printed. 


Available on: All machines. Restrictions: NorthNet Jetstream must be installed. 
Registers at call: Return Registers: 

AH = F2h AX 5 status 

DX = printer port (0-3) 0000h prior print request finished 


other number of characters left to print 
Conflicts: None known. 
See Also: Functions Flh and F3h 


INTERRUPT 17h - Function F3h 


ABORT PRINT OPERATION 

Purpose: Immediately terminate the printing currently in progress. 

Available on: All machines. Restrictions: NorthNet Jetstream must be installed. 
Registers at call: Return Registers: 

AH = F3h AX = number of unprinted characters due to abort 


DX = printer port (0-3) 
Conflicts: None known, 
See Also: Functions Fih and F4h 


INTERRUPT 17h - Function Fah 
SET COMPLETION (POST) ADDRESS 


Purpose: Specify the subroutine to invoke at the end of a print job. 
Available on: All machines. Restrictions: NorthNet Jetstream must be installed. 
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Registers at call: Return Registers: n/a 
AH = F4h 
DX = printer port (0-3) 
DS:DS -> FAR post address (called with interrupts 
on) 
Conflicts: None known. 
See Also: Functions Flh and F3h 


INTERRUPT 17h - Function F5h 
PRINT DATA BUFFER FROM EXTENDED MEMORY 


Purpose: Transmit the specified data stored in extended memory to the printer. 


Available on: All machines. Restrictions: NorthNet Jetstream must be installed. 
Registers at call: Return Registers: 

AH = FSh AX = status 

CX = data buffer length 0000h printer not ready (see also INT 17h Function 
DX = printer port (0-3) 02h in chapter 3) 

DS:SI -> data buffer (32-bit physical address) other printing started 


Conflicts: None known. 
See Also: Function F1 


KBUF 


INTERRUPT 16h - Function FFh 
ADD KEY TO TAIL OF KEYBOARD BUFFER 


Purpose: Store a keystroke which will be retrieved by a later keyboard read. 





Available on: All machines. Restrictions: KBUF must be installed. 
Registers at call: Return Registers: 
AH = FFh AX = status 
DX = scan code 0000h success 
000th failure 


Conflicts: PC Tools (chapter 33) 
See Also: Function 05h (chapter 3) 


The Last Byte 

The Last Byte by Key Software Products is a shareware high-memory manager designed to create upper memory 
blocks from shadow RAM on various chip sets, The two drivers from The Last Byte covered here are 
LASTBYTE.SYS, which directs the system's chip set to convert shadow RAM into directly usable memory, and 
HIGHUMM.SYS, which manages the converted memory, 


INTERRUPT 21h - Function 44h, Subfunction 02h 


GET Unknown TABLE 

Purpose: unknown, 

Available on: All systems. Restrictions: LASTBYTE.SYS version 1.19 or higher 
must be installed, 

Registers at call: Return Registers: 

AX = 4402h CF set on error 

BX = handle for device "LASTBYTE" AX = error code (see Function 59h, chapter 8) 

CX = 0004h CF clear if successful 

DS:DX -> DWORD to hold address of 39-byte AX = number of bytes read 


table of unknown. 
See Also: HIGHUMM.SYS Function 44h Subfunction 02h (below) 


INTERRUPT 21h - Function 44h, Subfunction 02h 
GET HIGHUMM API ADDRESS 
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Purpose: Determine the routine to call for communicating with the HIGHUMM memory manager. 


Available on: All systems, 

Registers at call: 

AX = 4402h 

BX = handle for device "KSP$UMM"” 
CX = 0004h 

DS:DX -> DWORD to hold entry point 


Restrictions: HIGHUMM.SYS must be installed. 
Return Registers: 
CF set on error 

AX = error code (see Function 59h, chapter 8) 
CF clear if successful 

AX = number of bytes read 


Details: HIGHUMM.SYS is used by calling its entry point as described in the following pages. 


Conflicts; DOS 2+ IOCTL (chapter 8), Network Driver Interface Specification (chapter 27), IBM System 36/38 


Workstation Emulation (chapter 26). 

Call entry point with: 

AH = 00h allocate UMB (same as XMS function 
10h) (see INT 2Fh Function 43h Subfunction 
10h, chapter 10) 

DX & size in paragraphs 


Call entry point with: 

AH = Oth deallocate UMB (same as XMS func 
1th) (see INT 2Fh Function 43h 
Subfunction 10h, chapter 10) 

DX = segment number of UMB 

Call entry point with: 

AH = 02h request a bank-switched memory block 

DX = size in paragraphs 


Call entry point with: 
AH = 03h release a bank-switched memory block 
DX = segment number 


Call entry point with: 

AH = 04h transfer data to/from high memory 
DS:SI -> source 

ES:DI -> destination 

CX = length in bytes 


Return Registers: 
AX = status code: 
000Ih successful 
BX = segment number 
DX = size of requested block 
0000h failed 
BL = error code: 
80h not implemented 
BOh insufficient memory, smaller block 
available 
Bth insufficient memory, no blocks 
available 
B2h invalid segment number 
DX = size of largest available block 
Return Registers: 
AX = status code: 
0001h successful 
0000h failed 
BL = error code (see Function 00h) 
Return Registers: 
AX = status code: 
0001h successful 
BX = segment number 
DX = size of requested block 
0000h failed 
BL = error code (see Function 00h) 
DX = size of largest available block 
Return Registers: 
AX = status code: 
0001h successful 
0000h failed 
BL = error code (see Function 00h) 
Return Registers: 
AX = status code: 
0001h successful 
0000h failed 
BL = error code (see Function 00h) 


Note: enables bank-switched memory, does the copy, then disables bank-switched memory, 
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Call entry point with: 
AH = 05h get a word from bank-switched memory 
ES:DI -> word to read 


Cail entry point with: 

AH = 06h put a word to bank-switched memory 
ES:DI -> word to write 

DX = word 


Call entry point with: 

AH = 07h put a byte to bank-switched memory 
ES:DI -> byte to write 

DL = byte 


Call entry point with: 
AH = 08h enable bank-switched memory 
DS:SI -> 6-byte status save area 


Call entry point with: 

AH = 09h disable bank-switched memory 

DS:SI -> 6-byte save area from enable call 
(Function 08h) 


Call entry point with: 

AH = 0Ah assign name to UMB or bank-switched 
block 

DX = segment number 

DS:SI -> 8-byte blank-padded name 

Call entry point with: 

AH = OBh locate UMB block by name 

DS:SI -> 8-byte blank-padded name 


Call entry point with: 
AH = 0Ch locate bank-switched block by name 
DS:SI -> 8-byte blank-padded name 


LPTx 


LPTx by Mark DiVecchio and Kepa Zubeldia is a printer output capturing program which stores the captured printer 
output in a disk file. The various versions use differing algorithms for capturing the printer output; as a result, for 


Return Registers: 
AX = status code: 
0001h successful 
DX = word 
0000h failed 
BL = error code (see Function 00h) 
Return Registers: 
AX = status code: 
0001h successful 
0000h failed 
BL = error code (see Function 00h) 
Return Registers: 
AX = status code: 
0001h successful 
0000h failed 
BL = error code (see Function 00h) 
Return Registers: 
AX = status code: 
000th successful 
0000h failed 
BL = error code (see Function 00h) 
Return Registers: 
AX = status code: 
0001h successful 
0000h failed 
BL = error code (see Function 00h) 
Return Registers: 
AX = status code: 
0001h successful 
0000h failed 
BL = error code (see Function 00h) 
Return Registers: 
AX = status code: 
Q00Ih successful 
BX = segment number 
DX = size of block 
0000h failed 
BL = error code (see Function 00h) 
Return Registers: 
AX = status code: 
0001h successful 
BX = segment number 
DX = size of block 
0000h failed 
BL = error code (see Function 00h) 


some versions of DOS, an older version of LPTx may work more reliably than a newer version. 





INTERRUPT 17h - Function OABCh 
v9.x INSTALLATION CHECK 


Purpose: Determine whether LPTx version 5.x ts installed. 


Available on: All machines. 
Registers at call: 
DX = 0OABCh 


Conflicts: None known. 


INTERRUPT 17h - Function 0B90h 
v6.x INSTALLATION CHECK 


Purpose: Determine whether LPTx version 6.x is installed. 


Available on: All machines. 
Registers at call: 
DX = 0B90h 


Conflicts: None known. 


INTERRUPT 17h - Function 0B91h 
V7.X INSTALLATION CHECK 


Purpose: Determine whether LPTx version 7.x is installed. 


Available on: All machines, 
Registers at call: 
DX = OB91h 


Conflicts: None known. 


INTERRUPT 17h - Function OFSFh 
V4.x INSTALLATION CHECK 


Purpose: Determine whether LPTx version 4.x is installed. 


Available on: Ali machines. 
Registers at call: 
DX = OF5Fh 


Conflicts: None known. 


MAGic 
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Restrictions: none. 

Return Registers: 

AX = AAAAh 

DX =BAAAh 

ES = code segment of resident portion 


Restrictions: none. 

Return Registers: 

DX = ABBBh 

ES = code segment of resident portion 


Restrictions: none. 

Return Registers: 

DX = ABCBh 

ES = code segment of resident portion 


Restrictions: none. 

Return Registers: 

AX = AAAAh 

DX = F555h 

ES = code segment of resident portion 


MAGic (MAGnification In Color) is a TSR by Microsystems Software, Inc. providing 2x2 text and graphics 
magnification on VGA, XGA, and SVGA systems, It uses INT 49h by default, but the interrupt number may be 
overridden on the commandline. The actual interrupt in use may be found by searching for the signature "MAGic" 
immediately preceding the interrupt handler (this is also the installation check). MAGic uses CodeRunneR, which 
places the signature "RT" at offset 0000h in the interrupt handler’s segment, followed by MAGic’s TSR ID of 
"VMAG". 


INTERRUPT 49h - Function 0001h 
TURN ON MAGNIFICATION 


Purpose: Begin displaying the screen contents with both height and width doubled. 
Available on: Systems equipped with VGA, Restrictions: MAGic version 1.16 or higher must be 
SuperVGA, or XGA displays. installed, 
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Registers at call: Return Registers: 

AX = 0001h AX = status 
0000h cannot magnify current video mode 
0002h magnified (text mode) 
0003h magnified (graphics mode) 
FFFDh function works only in magnified mode | 
FFFFh MAGic busy, retry later 


BX,CX,DX destroyed 
See Also: Functions 0001h, 0003h, and 0004h 
INTERRUPT 49h - Function 0002h 
TURN OFF MAGNIFICATION 
Purpose: Display the screen at its normal size. 
Available on: Systems equipped with VGA, Restrictions: MAGic version 1.16 or higher must be 
SuperVGA, or XGA displays. installed. 
Registers at call: Return Registers: 
AX = 0002h AX = status (see Function 0001h) 
BX,CX,DX destroyed 


See Also: Function 0001h 


INTERRUPT 49h - Function 0003h 
SHIFT MAGNIFIED WINDOW TO INCLUDE SPECIFIED LOCATION 


Purpose: Ensure that the specified location is visible on the magnified screen. 


Available on: Systems equipped with VGA, Restrictions: MAGic version 1.16 or higher must be 
SuperVGA, or XGA displays. installed. 
Registers at call: Return Registers: 
AX = 0003h AX = status 
BX = vertical position (character row [text] or pixel 0000h successful 
row [graphics]) FFFFh MAGic busy, retry later 
DX = horizontal position (char column [text] or 8- BX,CX,DX destroyed 


pixel units [graphics)}) 
Details: The window is not moved if the specified position is already inside the current window. 
See Also: Functions 0001h, 0004h, and 0005h 


INTERRUPT 49h - Function 0004h 
REPOSITION MAGNIFIED WINDOW 


Purpose: Specify a new location for the window into the magnified screen. 


Available on: Systems equipped with VGA, Restrictions: MAGic version 1.16 or higher must be 
SuperVGA, or XGA displays. installed. 

Registers at call: Return Registers: 

AX = 0004h AX = status (see Function 0003h) 

BX = vertical position of upper left corner BX,CX,DX destroyed 


DX = horizontal position 
See Also: Functions 0001h, 0003h, and 0005h 


INTERRUPT 49h - Function 0005h 
GET POSITION OF MAGNIFIED WINDOW 


Purpose: Determine which portion of the screen is currently visible with magnification. 
Available on: Systems equipped with VGA, Restrictions: MAGic version 1.16 or higher must be 
SuperVGA, or XGA displays. installed. 
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Registers at call: Return Registers: 
AX = 0005h AX = status 
0000h successful 


BX = vertical position (character or pixel row) 
DX = horizontal position (character column 
or 8-pixel units) 
FFFFh MAGic busy, retry later 


BX,DX destroyed 
CX destroyed 
See Also: Functions 0001h, 0003h, 0004h, 0006h, and 0007h 
INTERRUPT 49h - Function 0006h 
GET SIZE OF FULL SCREEN 
Purpose: Determine the actual size of the full display area. 
Available on: Systems equipped with VGA, Restrictions: MAGic version 1.16 or higher must be 
SuperVGA, or XGA displays. installed. 
Registers at call: Return Registers: 
AX = 0006h AX = status 
0000h successful 


BX = vertical size (character or pixel rows) 
DX = horizontal size (character columns or 
8-pixel units) 
FFFFh MAGic busy, retry later 
BX,DX destroyed 
CX destroyed 
See Also: Functions 0001h, 0005h, and 0007h 


INTERRUPT 49h - Function 0007h 
GET SIZE OF MAGNIFICATION WINDOW 


Purpose: Determine the size of the visible portion of the screen when magnified. 


Available on: Systems equipped with VGA, Restrictions: MAGic version 1.16 or higher must be 
SuperVGA, or XGA displays. installed. 
Registers at call: Return Registers: 
AX = 0007h AX & status 
0000h successful 


BX = vertical size (character or pixel rows) 
DX = horizontal size (character columns or 
8-pixel units) 
FFFEh invalid function 
FFFFh MAGic busy, retry later 
BX,DX destroyed 
CX destroyed 
BUG: In versions 1,16 and 1.17, this function is not recognized as valid, but Function 0000h is accepted and will 
branch to an invalid address. 
See Also: Functions 0001h and 0006h 


MAKEY 
MAKEY is a utility by System Enhancement Associates. 


INTERRUPT 16h - Function 80h 
INSTALLATION CHECK 


Purpose: Determine whether MAKEY.COM has been loaded, 
Available on: All machines, Restrictions: none. 
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Registers at call: Return Registers: 

AH = 80h AX = 1954h if installed 
Conflicts: None known. 

MDEBUG 


MDEBUG is a shareware memory-resident debugger by Bernd Schemmer. It consists of a main program, a 
command driver and a display driver; the interfaces used by the main program to call the two drivers are described 
here, followed by the API of the main program. 

MDEBUG can use any two consecutive multiplex numbers between COh and FFh; the default is DOh for the 
display driver and Dih for the command driver. 


INTERRUPT 2Fh - Function DOh, Subfunction 00h 
GET DISPLAY DRIVER STATUS 


Purpose: Called by MDEBUG to determine the version, location, and current state of the display driver. 


Available on: All machines. Restrictions: MDEBUG display driver must be 
installed. 

Registers at call: Return Registers: 

AX = DOOOh CF set on error 


{all other registers must be unchanged) 
CF clear if successful 
AL = FFh 
AH = driver semaphore 
00h driver is not active 
Olh driver is active 
BX = code segment of the driver 
CX = driver version (CH = major, CL = minor, 
must be >= 0151h) 
DL = buffer semaphore 
00h driver is not pending 
Olh driver is pending between functions 02h 
and 03h 
DH = show semaphore 
00h driver is not pending 
O1h driver is pending between functions 04h 
and 05h 
Details: This function MUST be reentrant, as MDEBUG calls it after every popup before any other actions. The 
handler should not change any registers if the display is in an unsupported mode or in a mode MDEBUG supports 
itself, e.g, a normal text mode like 80x25. In this case MDEBUG will not call any of the other functions for this 
popup session, 
MDEBUG will not call the other functions if the returned version is less than the actual version of MDEBUG. 
If the driver is reentrant, DL and DH should be 00h. 
Conflicts: None known, 
See Also: Function DOh Subfunctions 01h, 02h, 03h, 04h, and 05h 


INTERRUPT 2Fh - Function DOh, Subfunction 01h 
INITIALIZE DISPLAY DRIVER 


Purpose: Prepare the display driver for operation in an MDEBUG popup session. 





Available on: All machines. Restrictions; MDEBUG display driver must be 
installed. 

Registers at call: Return Registers: 

AX = DOOIh CF set on error 


AL = driver semaphore 
AH = buffer semaphore 
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Details: MDEBUG calls this function after every succesful call of Function 00h. The handler should reset all internal 
data and the status of the driver. If this function returns an error, MDEBUG will not call the other functions in this 
popup session. 

Conflicts: None known. 

See Also: Function DOh Subfunction 00h 


INTERRUPT 2Fh - Function DOh, Subfunction 02h 


SAVE GRAPHIC DATA 

Purpose: Store the current contents of the screen for restoration when MDEBUG pops down. 

Available on: All machines. Restrictions; MDEBUG display driver must be 
installed. 

Registers at call: Return Registers: 

AX = D002h CF set on error 


CF clear if successful 
display memory saved and display switched to one 
of the text modes 02h, 03h or 07h. 
Details: MDEBUG calls this function only once every popup session before displaying its windows. 
Conflicts: None known. 
See Also: Function DOh Subfunctions 00h and 03h 


INTERRUPT 2Fh - Function DOh, Subfunction 03h 


RESTORE GRAPHIC DATA 

Purpose: Restore the screen contents to the state they were in prior to MDEBUG popping up. 

Available on: All machines. Restrictions; MDEBUG display driver must be 
installed. 

Registers at call: Return Registers: 

AX = D003h CF set on error 


CF clear if successful 
display restored to the mode it was in before 
calling Function DOh Subfunction 02h and the 
display memory is restored 
Details: MDEBUG calls this function only once every popup session just before it exits to normal DOS, 
Conflicts: None known, 
See Also: Function DOh Subfunctions 00h and 02h 


INTERRUPT 2Fh - Function D0h, Subfunction 04h 
MDEBUG display driver - SHOW SAVED DATA 


Purpose: Temporarily restore the screen to the state it was in when MDEBUG popped up. 


Available on: All machines. Restrictions: MDEBUG display driver must be 
installed. 

Registers at call: Return Registers: 

AX = D004h CE set on error 


CF clear if successful 
display switched to mode it was in before calling 
Function DOh Subfunction 02h and the display 
memory is restored 
Details: This function need not save the display memory before changing it. 
Conflicts: None known. 
See Also: Function DOh Subfunctions 00h and 05h 


INTERRUPT 2Fh - Function DOh, Subfunction 05h 
MDEBUG display driver - SWITCH BACK TO TEXT SCREEN 


Purpose: Return to MDEBUG's screen display after showing the saved screen. 
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Available on: All machines. Restrictions: MDEBUG display driver must be 
installed. 
Registers at call: Return Registers: 
AX = DO05h CF set on error 
CF clear if successful 


display restored to mode it was in before calling 
Function DOh Subfunction 04h 
Details: This function need not save or change the display memory. 
Conflicts: None known, 
See Also: Function DOh Subfunctions 00h and 04h 


INTERRUPT 2Fh - Function D0h, Subfunctions 06h-7Fh 


RESERVED FUNCTIONS 

Purpose: These functions are reserved for future use. 

Available on: All machines. Restrictions; MDEBUG display driver must be 
installed. 

Registers at call: Return Registers: unknown. 

AH = D0h 

AL = 06h-7Fh 


Conflicts: None known. 
INTERRUPT 2Fh - Function DOh, Subfunctions 80h-FFh 
USER DEFINED FUNCTIONS 


Purpose: These functions numbers are reserved for user defined features (e.g. communication between the transient 
und resident parts of the driver). 


Available on; All machines, Restrictions; MDEBUG display driver must be 
installed, 

Registers at call: Return Registers: user-defined 

AH = DOh 

AL = 80h-FFh 


Conflicts: None known. 


INTERRUPT 2Fh - Function D1h, Subfunction 00h 
GET COMMAND DRIVER STATUS 


Purpose: Determine the version and state of the command driver. 


Available on: All machines. Restrictions; MDEBUG command driver must be 
installed, 
Registers at call: Return Registers: 
AX = D100h DL =FFh 
BX = version of MDEBUG (BH = major, BL = BX = version number of the driver if it is less than the 
minor) version in BX, else unchanged 
CX = command driver counter CX incremented 
---V 160+ 


DS:SI -> MDEBUG identification table (Table 36-11) 
ES = segment of display memory used by MDEBUG 
DI = size of video mode used by MDEBUG (high 
byte = lines, low byte = columns) 
Details: This function must end with a far call to the old INT 2Fh handler after changing the registers. This function 
MUST be reentrant. If the version number returned in BX is less than the version of MDEBUG, MDEBUG will not 
call any of the other functions during this popup session. 
Command drivers must also declare the data listed in Table 36-12 at the given offsets in the code segment. 
MDEBUG will pass every key and command to the command driver(s) before checking for a valid internal 
command. 





| 
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Conflicts: None known. 
See Also: Function DOh Subfunction 00h, Function D1h Subfunction 01h 


Table 36-11. Format of MDEBUG Identification Table: 


Offset Size Description 

- WORD entry offset 

00h WORD CS of MDEBUG 

02h DWORD _ old INT 08h vector 

06h DWORD old INT 09h vector 

OAh DWORD address INT 16h routine used by MDEBUG 
OEh BYTE length of version string 

OFh NBYTEs _ version string 


Table 36-12. Format of MDEBUG Command Driver Data: 


Offset Size Description 

100h 3BYTEs JMP-command in .COM-files 

103h BYTE NOP-command (90h) 

104h 26BYTEs signature "Kommandotreiber fiir MDEBUG" 

LTEh 12 BYTEs name of driver, e.g. "MDHISDRV.COM". Each driver must have a unique name 


INTERRUPT 2Fh - Function Dih, Subfunction 01h 
INITIALIZE COMMAND DRIVER 


Purpose: Prepare the command driver for operation. 


Available on: All machines. Restrictions: MDEBUG command driver must be 
installed. 

Registers at call: Return Registers: 

AX=D101h DL = FFh if successful 

CX = command driver counter CX incremented 


else error: all registers unchanged 
Details: This function must be reentrant and must end with a far call to the old INT 2Fh handler after changing the 
registers. 
Conflicts: None known, 


INTERRUPT 2Fh - Function D1h, Subfunction 02h 
EXECUTE DEBUGGER COMMAND 


Purpose: Perform an action specified by the given string. 


Available on: All machines. Restrictions: MDEBUG command driver must be 
installed. 

Registers at call: Return Registers: 

AX =D102h AL = FFh 

BL = first character of the debugger command CF set on error 

BH = last character of the debugger command (or AH = error number 
blank) OIh syntax error 

DS:SI -> parameter for the debugger command as 02h first shell of COMMAND.COM is active 
ASCIZ, string 03h Esc pressed 

DS:DI -> MDEBUG data structure (Table 36-13) 04h Break pressed 


O0Sh dos-busy-flag not zero 
06h command ended 

07h division by zero 

08h invalid display driver 
09h invalid command driver 
OAh both errors 8 and 9 
OBh unknown error 


| 
| 
| 
| 
i 
| 
| 
| 








36-40 Miscellaneous APIs 


OCh new error 
DS:SI -> ASCIZ error message (max 30 
characters) 
else unknown error 


CF clear if successful 
AH = return code 


00h continue processing the command line 

Olh leave MDEBUG popup session 

02h leave MDEBUG popup session and 
automatically popup again if the InDOS 
flag is zero 

03h put new command line into the input 
buffer, DS:SI -> new command line 
(ASCIZ string, max 66 chars) 

04h process new command line, DS:SI -> new 
command line (ASCIZ string, max 66 
chars) 

else unknown status, but continue processing 
commmand line 


Details: This function must end with a far call to the old INT 2Fh handler (with registers unchanged) if the driver 
does not support the debugger command in BX. Otherwise, the driver must not chain to the old INT 2Fh. 


Table 36-13. Format of MDEBUG Data Structure: 


Offset 
00h 
02h 
04h 
06h 
08h 
OAh 
0Ch 
OEh 
10h 
12h 
14h 
16h 
18h 
1Ah 
1Ch 
1Eh 
20h 
22h 
24h 
26h 
28h 
2Ah 
2Ch 
2Eh 
30h 
32h 
34h 
36h 
38h 
3Ah 


Size 

WORD 
WORD 
WORD 
WORD 
WORD 
WORD 
WORD 
WORD 
WORD 
WORD 
WORD 
WORD 
WORD 
WORD 
WORD 
WORD 
WORD 
WORD 
WORD 
WORD 
WORD 
WORD 
WORD 
WORD 
WORD 
WORD 
WORD 
WORD 
WORD 


Description 

register SE (segment) 
register OF (offset) 
register FS 

register FO 

register AX 

register BX 

register CX. 

register DX 

register SI 

register DI 

register DS 

register ES 

register BP 

register SS 

register SP 

register FL (flags) 

register RO 

register R1 

register R2 

register R3 

register R4 

register RS 

register R6 

register R7 

register R8 

register CS, return-address 
register IP, return-address 
saved data for key <F6>, segment 
saved data for key <F6>, offset 


12 WORDs saved registers for the key <F8> (original register values at popup entry of MDEBUG) 
AX, BX, CX, DX, SI, DI, DS, ES, BP, SS, SP, flags 
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Table 36-13. Format of MDEBUG Data Structure (continued) 


Offset 
52h 


6Ah 
6Eh 
72h 
74h 
76h 
78h 
7Ah 
7Ch 


Size Description 

12 WORDs saved registers for the key <SHIFT-F8> AX, BX, CX, DX, SI, DI, DS, ES, BP, SS, SP, 
flags 

DWORD _ address of the DOS-invars-table 

DWORD address of the InDOS flag 

WORD offset of the register which is used for the segment of the first monitor window 

WORD offset of the register which is used for the offset of the first monitor window 

WORD name of the register which is used for the segment of the first monitor segment 

WORD name of the register which is used for the offset of the first monitor window 

WORD pseudo register 1 

WORD pseudo register 2 


INTERRUPT 2Fh - Function Dih, Subfunction 03h 
EXECUTE KEY IN THE MONITOR 


Purpose: Perform the monitor action corresponding to the indicated key. 


Available on: All machines. 


Restrictions; MDEBUG command driver must be 


installed. 
Registers at call: Return Registers: 
AX =D103h AL = FFh 
BX = key code (like result of an interrupt 16h call) AH = return code 


CX = 0 if the cursor is in the ASCII column of the 


monitor 


CX = 1 if the cursor is in one of the hex fields of 


the monitor 
DS:SI -> MDEBUG data structure (Table 36-13) zero 


ES:DI -> actual byte in the monitor 


00h key processed, read next key 

Oh leave MDEBUG popup session 

02h leave MDEBUG popup session and 
automatically popup again if the InDOS flag is 


03h signal an error (beep) 

O4h driver has redefinded the key, proceed with the 
new key: BX = new key code. MDEBUG will 
not pass the new key to the command driver 

else treat like code 00h 


Details: This function must end with a far call to the old INT 2Fh handler (with registers unchanged) if the driver 
does not support the key in BX. Otherwise, the driver must not chain to the old INT 2Fh. 


Conflicts: None known. 


See Also: Function D1h Subfunction 04h 


INTERRUPT 2Fh - Function D1h, Subfunction 04h 
EXECUTE KEY IN THE DEBUGGER 


Purpose: Perform the debugger action corresponding to the indicated key. 


Available on: All machines. 


Restrictions: MDEBUG command driver must be 


installed. 
Registers at call: Return Registers: 
AX = D104h AL=FFh 
DS:SI -> MDEBUG data structure (see Function AH = return code 
Dth Subfunction 02h) 00h key processed, read next key 


Oh leave MDEBUG popup session 

02h leave MDEBUG popup session and 
automatically popup again if the DOS-busy 
flag is zero 

03h signal an error (beep) 

04h driver has redefinded the key, proceed with the 
new key: BX = new key code. MDEBUG 
won't pass the new key to the command driver 
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05h put new command line into the input buffer 
DS:SI -> new command line (ASCIZ string, 
max 66 chars) 
OGh process new command line 
DS:SI -> new command line (ASCIZ string, 
max 66 chars) 
else treat like code 00h 
Details: This function must end with a far call to the old INT 2Fh handler if the driver does not support the key in 
BX. Otherwise, the driver must not chain to the old INT 2Fh. 
Conflicts: None known. 
See Also: Function Dih Subfunction 03h 


INTERRUPT 2Fh - Function D1h, Subfunctions 05h-0Ah 


RESERVED FUNCTIONS 

Purpose: These functions are reserved for future use. 

Available on: All machines. Restrictions: MDEBUG command driver must be 
installed, 

Registers at call: Return Registers: n/a 

AH=D1h 

AL = 05h-0Ah 


Conflicts: None known, 


INTERRUPT 2Fh - Function D1th, Subfunction 10h 
GET ADDRESS OF THE OLD INT 2Fh HANDLER 


Purpose: Determine which handler received control on an INT 2Fh before MDEBUG was loaded. 








Available on: All machines. Restrictions; MDEBUG command driver must be 
installed. 

Registers at call: Return Registers: 

AX=D110h DL = FFh 


ES:BX -> next program in the chain for INT 2Fh 

CX = code segment of this driver 
Details: This function is only called by the transient part of the driver. It must be reentrant and the driver must not 
chain this function to the old INT 2Fh vector. 
Conflicts: None known. 


INTERRUPT 2Fh - Function Dih, Subfunction 11h 


START COMMAND DRIVER 

Purpose: Called by the transient part of the command driver to inform the resident part that it has begun execution. 

Available on: All machines. Restrictions: MDEBUG command driver must be 
installed. 

Registers at call: Return Registers: 

AX =D11ih DL = FFh 


Details: The function must be reentrant and the driver must not chain this function to the old INT 2Fh. 
Conflicts: None known. 
See Also; Function D1h Subfunctions Olh and 12h 


INTERRUPT 2Fh - Function D1h, Subfunction 12h 


END COMMAND DRIVER 

Purpose: Called by the transient part of the dirver to inform the resident part that it will be released after the call. 

Available on: All machines. Restrictions; MDEBUG command driver must be 
installed. 

Registers at call: Return Registers: 


AX=D112h DL =FFh 
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Details: The function must be reentrant and the driver must not chain this function to the old INT 2Fh. 
Conflicts: None known. 
See Also: Function D1h Subfunctions 01h and 11h 


INTERRUPT 2Fh - Function D1h, Subfunctions 13h-7Fh 


RESERVED FUNCTIONS. 

Purpose: These functions are reserved for future use. 

Available on; All machines. Restrictions: MDEBUG command driver must be 
installed. 

Registers at call: Return Registers: n/a 

AH=DIh 

AL = 13h-7Fh 


Conflicts: None known, 
INTERRUPT 2Fh - Function D1h, Subfunctions 80h-FFhh 
USER DEFINED FUNCTIONS 


Purpose: These functions are reserved for user defined features (e.g. communication between the transient und 
resident parts of the driver). 





Available on: All machines, Restrictions; MDEBUG command driver must be 
installed. 

Registers at call: Return Registers: user-defined 

AH=Dth 


AL = 80h-FFh 
Conflicts: None known. 


INTERRUPT 60h - Function 00h 


GET STATUS 
Purpose: Determine MDEBUG's current status, including its colors, hotkey, and multiplex number. 
Available on: All machines. Restrictions; MDEBUG display driver must be 
installed. 
Registers at call: Return Registers: 
AH = 00h AX = return code 
DS:SI -> password or a null byte FFFEh password is invalid 
FFFDh display mode is invalid 
else successful 


BS = value of monitor register SE 

DI = value of monitor register OF 

CH = monitor color 

CL = debugger color 

BH = monitor start line 

BL = debugger start line 

AH = makecode of the hotkey 

AL = ASCII code of the hotkey 

DL = status of special keys (only SHIFT, ALT, 
CTRL) for the hotkey, coded as for the 
keyboard flag at 0040h:0017h 

DH = basic process number for the 
communication with drivers; DH = 
multiplex number for the display driver, 
DH+1 = multiplex number for the 
command driver(s) 

DS:SI -> MDEBUG identification table 
(Table 36-14) 
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Details: MDEBUG uses INT 60h by default, but may be directed to any of INT 60h through INT 67h; the interrupt 
is not chained. If DS:SI points at a null byte, MDEBUG will prompt for a password if passwords are active; enough 


stack space must be provided for an INT 10h call. 
Conflicts: See chapter 1. 
See Also: Function 02h 


Table 36-14. Format of MDEBUG Identification Table: 


Offset Size Description 

-2 WORD entry offset 

00h WORD CS of MDEBUG 

02h DWORD _ old INT 08h vector 

06h DWORD old INT 09h vector 

OAh DWORD address INT 16h routine used by MDEBUG 
OEh BYTE length of version string 

OFh NBYTEs _ version string 


INTERRUPT 60h - Function 01h 
GET ADDRESS OF THE HELP REGISTERS 


Purpose: Determine the location of the debugger's help registers, 


Available on: All machines, 
Registers at call: 

AH =0Ih 

DS:SI -> password or a null byte 


Conflicts: See chapter 1. 


INTERRUPT 60h - Function 02h 
SET STATUS 


Restrictions: MDEBUG must be installed. 
Return Registers: 
AX = return code 
FFFEh password is invalid 
FFEDh display mode is invalid 
else successful 
ES:DI point to the help registers of MDEBUG 
ES:DI-02h -> RO 
ES:DI ->RI 
ES:DI+02h -> R2 


ES:DI+0Eh-> R8 


Purpose: Specify new colors, location on screen, hotkey, and multiplex number for the debugger. 


Available on: All machines. 

Registers at call: 

AH = 02h 

DS:SI -> password or a null byte 

ES = new value for the register SE 

DI = new value for the register OF 

CH = new monitor color if nonzero 

CL = new debugger color if nonzero 

BH = new monitor start line if nonzero 

BL = new debugger start line if nonzero 

AL = new ASCII code for the hotkey ('A‘..'Z’, ‘a‘..'z') 
if nonzero 

DL = new status of the special keys (SHIFT, ALT, 
CTRL) for the hotkey if nonzero 


Restrictions: MDEBUG must be installed. 
Return Registers: 
AX = return code 
FFFFh call not allowed 
FFFEh password is invalid 
FFFDh display mode is invalid 
0000h successful, status changed 
else AL = error code 
bit O invalid monitor start line 
1 invalid debugger start line 
2 invalid hotkey 
3 invalid process number 
4-7 reserved 
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DH = if nonzero, new basic process number for 
communication with the drivers; 
DH = multiplex number for the display driver 
DH+1 = multiplex number for command driver 


Details: The values of the debugger registers SE (segment) and OF (offset) are always changed; the other values are 


only changed if they are nonzero and valid. 
Conflicts: See chapter I. 
See Also: Function 00h 


INTERRUPT 60h - Function 03h 


POP UP 

Purpose: Request that the debugger pop up with the specified debugging address. 

Available on: All machines. Restrictions: MDEBUG must be installed. 
Registers at call: Return Registers: 

AH =03h AX = return code 

DS:SI -> the password or a null byte FFFFh call not allowed 

ES -> new value for register SE FFFEh password is invalid 

DI -> new value for register OF FFFDh display mode is invalid 


else successful 
Conflicts: See chapter 1. 
See Also: Function 04h 


INTERRUPT 60h - Function 04h 


POP UP 

Purpose: Request that the debugger pop up with the current debugging address. 

Available on: All machines, Restrictions: MDEBUG must be installed. 
Registers at call: Return Registers: 

AH = 04h AX = return code 

DS:SI -> password or a null byte FFFFh call not allowed 


FFFEh password is invalid 
FFFDh display mode is invalid 
else successful 

Conflicts: See chapter [. 


See Also: Function 03h 
INTERRUPT 60h - Function 05h 
GET AND SET MDEBUG FLAGS 
Purpose: Determine the current values of the popup enable and INT 08h flags, then adjust the popup enable flag. 
Available on: All machines. Restrictions: MDEBUG must be installed. 
Registers at call: Return Registers: 
AH = 05h AX = return code 
DS:SI -> password or a null byte FFFEh password is invalid 
BL = new value for the MDEBUG semaphore FFFDh display mode is invalid 
00h enable popup of MDEBUG else successful 
else disable popup of MDEBUG BL = old value of the MDEBUG 
semaphore 


BH = old value of the INT 08h 
semaphore (this semaphore is 
always reset after this function) 

Conflicts: See chapter 1. 


| 
| 
| 
| 
| 
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INTERRUPT 60h - Function 06h 


GET PASSWORD STATUS 

Purpose: Determine whether a password is being used. 

Available on: All machines. Restrictions: MDEBUG must be installed. 
Registers at call: Return Registers: 

AH = 06h AL = status 


00h password inactive 
Olh password active 
Conflicts: See chapter 1. 


Microsoft Word 


INTERRUPT 16h - Function 55h, Subfunction 00h 
internal - MICROSOFT WORD COOPERATION WITH TSR 


Purpose: Called by MS Word to determine whether it should install its own INT 09h and INT 16h handlers. 


Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AX = 5500h AX = 4D53h if keyboard TSR present 


Details: During startup, Microsoft Word tries to communicate with any TSRs that are present using this call, If the 
return is not 4D53h, Word installs its own INT 09h and INT 16h handlers; otherwise it assumes that the TSR will 
handle the keyboard. 

Conflicts: None known. 


Minix 

Minix is an AT&T Unix Version 7-compatible operating system by Andrew Tanenbaum which includes complete 
source code. 

INTERRUPT 20h 

Minix - SEND/RECEIVE MESSAGE 

Purpose: Request services of the Minix kernel. 


Available on: All machines. Restrictions: Minix operating system must be 
installed. 
Registers at call: Return Registers: 
AX = process ID of other process various 
BX -> message: 
CX = | send 
2 receive 


3 send&receive 
Details: The message contains the system call number (numbered as in V7 Unix(tm)) and the call parameters. 
Conflicts: DOS Terminate Program (chapter 8). 


NDOS 
Symantec has licensed 4DOS version 3.03 for inclusion with the Norton Utilities. The API is identical to that for 
4DOS (see above) with the following exceptions: 

1, INT 2Fh calls use AH=E4h rather than AH=D4h. 

2. The installation check returns AX=44EEh rather than AX=44DDh. 

3. The character device for KEYSTACK.SYS is called NDOSSTAK rather than 4DOSSTAK. 


Norton Utilities 

The Norton Utilities (now owned by Symantec) are a series of programs for data recovery, hard disk management, 
batch file enhancement, etc. A number of the programs in the package are TSRs, and use the multiplex interrupt for 
communication. 





INTERRUPT 2Fh - Function FEh, Subfunction 00h 


INSTALLATION CHECK/STATUS REPORT 
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Purpose: Determine whether specific Norton Utilities 5.0 TSRs are installed, and whether they are enabled. 


Available on: All machines. 

Registers at call: 

AX = FEOOh 

DI = 4E55h ("NU") 

SI = TSR identifier 
4346h ("CF") NCACHE-F 
4353h ("CS") NCACHE-S 
4443h ("DC") DISKREET 
444Dh ("DM") DISKMON 
4653h ("FS") FILESAVE 


Conflicts: See chapter 1. 


OPTHELP.COM 


Restrictions: none. 
Return Registers: 
SI = TSR reply (lowercase version of SI on entry) 
AH = state 
00h installed but internally disabled 
Olh installed and enabled 
AL & status 
00h NCACHE or DISKREET installed 
Oth FILESAVE installed 
45h DISKMON installed 
BX = length of *.INI file (DISKMON and FILESAVE 
only) 
CX = segment of resident portion 
DL = unknown (FILESAVE only) 
DX = unknown (DISKMON only) 


OPTHELP is an optionally-resident help system for SLR Systems's OPTASM assembler. 


INTERRUPT 6Ah 
OPTHELP.COM 


Purpose: Communicate with the resident OPTHELP program. 


Available on: All machines. 
Registers at call: unknown. 


Restrictions: OPTHELP must be installed. 
Return Registers: unknown. 


Details: OPTHELP may be configured to use any interrupt from 60h to 7Fh (the default is 6Ah). 
Conflicts; DECnet DOS Local Area Transport Program (chapter 24). 


PC Magazine PCSpool 


PC Magazine's PCSpool is a print spooler which can store captured printer output either in RAM or on disk. It can 
control up to three printers at once, and allows control of the print queue. 


INTERRUPT 17h - Function COh 
GET CONTROL BLOCK ADDRESS 


Purpose: Determine the current status of the specified by retrieving the printer's control block, 


Available on: All machines. 
Registers at call: 

AH =COh 

DX = printer port (0-3) 
Conflicts: None known. 
See Also: Function Clh 


Table 36-15. Format of PCSpool Control Block: 


Offset Size Description 

00h WORD printer number 

02h WORD address of printer status port 
04h WORD number of first record in queue 
06h WORD number of last record in queue 


Restrictions: PC Magazine PCSpool must be installed. 
Return Registers: 
ES:BX -> control block (Table 36-15) 
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Table 36-15. Format of PCSpool Control Block (continued) 


Offset Size Description 
08h DWORD characters already printed 
0Ch DWORD number of characters remaining 
10h DWORD pointer to dequeue buffer 
14h DWORD previous count of characters printed 
18h DWORD _ number of clock ticks taken to print them 
1Ch WORD offset of next character to output 
1Eh WORD offset of next character to print 
20h WORD pointer to spooling queue record 
22h BYTE current spooling status 
23h BYTE current printer status: 
00h OK 
Olh not ready 
02h paused with message 
03h paused 
04h initializing 





FEh non-existent port 


FFh not spooled 
24h BYTE current control record type 
25h WORD observed printer speed 
27h WORD characters to print per service 
29h BYTE Olh if disk write needed 
2Ah BYTE O1h if queued data should be flushed 
2Bh BYTE Olh to update cps status 


INTERRUPT 17h - Function Cth 
BUILD PAUSE CONTROL RECORD 


Purpose: Insert a pause record into the specified printer's queue. 


Available on: All machines. Restrictions: PC Magazine PCSpool must be installed. 
Registers at call: Return Registers: n/a 
AH=Clh 


DX = printer port (0-3) 

DS:SI -> ASCIIZ string to save for display 
Details: This call flushes any pending writes. 
Conflicts: None known. 

See Also: Functions COh and C2h 


INTERRUPT 17h - Function C2h 


FLUSH PENDING WRITES 

Purpose: Force all buffered data to be written to the queue or sent to the printer. 

Available on: All machines, Restrictions: PC Magazine PCSpool must be installed. 
Registers at call: Return Registers: n/a 

AH =C2h 


DX = printer port (0-3) 
Conflicts: None known. 
See Also: Function C3h 


INTERRUPT 17h - Function C3h 
CANCEL PRINTER QUEUE (DISCARD ALL QUEUED OUTPUT) 


Purpose: Discard all pending output for the specified printer. 


Available on: Ali machines. Restrictions: PC Magazine PCSpool must be installed. 
Registers at call: Return Registers: n/a 
AH =C3h 


DX = printer port (0-3) 
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Conflicts: None known. 
See Also: Functions C2h and C7h 


INTERRUPT 17h - Function C4h 
QUERY SPOOLER ACTIVE (INSTALLATION CHECK) 


Purpose: Determine whether the spooler is present. 


Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AH =C4h DI = BOBFh 


SI = spooler segment 


Conflicts: None known, 


INTERRUPT 17h - Function C5h 


JOB SKIP PRINTER QUEUE 

Purpose: Discard one or more print jobs. 

Available on: All machines. Restrictions: PC Magazine PCSpool must be installed. 
Registers at call: Return Registers: n/a 

AH = C5h 


DX = printer port (0-3) 
Details: This call cancels all print jobs up to the pause record. 
Conflicts: None known, 


INTERRUPT 17h - Function C6h 
CHECK PRINTER QUEUE STATUS 


Purpose: Determine whether the printer is currently busy. 








Available on: All machines. Restrictions: PC Magazine PCSpool must be installed. | 
Registers at call: Return Registers: i 
AH = C6h AX = 0 printer not active or at pause | 
DX = printer port (0-3) = | printer busy | 


Conflicts: None known. 


/ 
INTERRUPT 17h - Function C7h 


CLOSE QUEUE 

Purpose: Close the disk file containing the printer queue, 

Available on: All machines. Restrictions: PC Magazine PCSpoo! must be installed. 
Registers at call: Return Registers: n/a 

AH = C7h 


DX = printer port (0-3) 
Conflicts: None known. 
See Also: Function C3h 


PC Magazine PUSHDIR.COM 
PC Magazine's PUSHDIR.COM and POPDIR.COM provide the ability to remember the current directory and return 
to it at a later time, with up to six levels of nesting. The first time it is ran, PUSHDIR becomes resident, providing 


the storage for the current directories for that and all subsequent invocations, 


INTERRUPT 16h - Function 77h, Subfunction 88h 

PUSHDIR INSTALLATION CHECK 

Purpose: Determine whether PUSHDIR.COM is installed. 

Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AX = 7788h AX = 7789h 
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BX = 7789h BX = 7788h 

DS:SI -> signature string SI destroyed 
"PUSHDIR VERSION 1.0" 

Conflicts: WATCH.COM, PcAnywhere III (chapter 28). 


PC-IPC 


PC-IPC is a shareware TSR by Donnelly Software Engineering which allows communication between independent 
programs. 


INTERRUPT 60h 

PC-IPC API 

Purpose: Communicate with PC-IPC. 

Available on: All machines. Restrictions: PC-IPC must be installed. 
Registers at call: Return Registers: 

STACK: DWORD pointer to parameter block STACK: unchanged 


(Table 36-16) 
Details: INT 60h is the default, but any interrupt vector may be used by specifying the vector on the commandline. 
Conflicts: See chapter 1. 


Table 36-16. Format of PC-IPC Parameter Block: 


Offset Size Description 

00h WORD caller's ID 

02h WORD to ID 

04h WORD command code (Table 36-17) 
06h WORD returned status 


bit 0: unused 
bit 1: IPC enabled 
bit 2: IPC installed 


bit 3: error 

bit 4: message(s) available 
O8h WORD returned error code (Table 36-18) 
OAh WORD size of data 
0Ch DWORD pointer to data buffer 


Table 36-17. Values of PC-IPC command codes; 


Value Mnemonic Command Action 

Olh "IPC_CMND_INQUIRE" inquire current status: Set status field, writes WORD to data buffer 
containing free message space in bytes, and sets the 
"size" field to the number of messages waiting. 


02h “IPC_CMND, ENABLE" reenable PC-IPC: Ignored unless called with the same ID that 
disabled PC-IPC. 

03h "IPC_CMND_DISABLE" disable PC-IPC 

04h "IPC_CMND_INSTALL” reset PC-IPC 

06h "IPC_CMND_RDATA" read data: Returns first message in data buffer, sets "size" to message 


length and "to ID" field to sender's ID. If no messages available, bit 4 
of status is cleared 
and "size" is set to zero. 


07h "IPC_CMND_SDATA" send data 

08h "IPC_CMND_REQID" require user ID: Create a new recognized ID and return in "caller's 
ID" field. 

09h "IPC_CMND_DELID" cancel user ID: Delete caller's ID from pool of recognized IDs. 

OAh “"TPC_CMND_RDATAW" read data, wait if no messages available 

OBh "IPC_CMND_VERS'" get PC-IPC version: String representing version returned in data buffer, "size" 


field set to length of string. 


| 
| 
| 








i 
} 
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Table 36-18. Values for PC-IPC error codes: 


Value Meaning Value Meaning 
00h no error 06h invalid destination process ID 
Olh invalid command or parameter O7h invalid sending process ID 
02h only process 0 can install/reset IPC 08h invalid data destination 
03h process can not install/reset IPC 09h no more process IDs available 
04h IPC is not enabled OAh can not relinquish that process ID 
05h process can not disable IPC OBh message space is full 

0Ch IPC is not installed 
PC/370 


PC/370 is an IBM 370 emulator by Donald S, Higgins. 
INTERRUPT 2Fh - Function 7Fh, Subfunction 24h 


Unknown Function 

Purpose: unknown function called by PC/370. 

Available on: All machines. Restrictions: PC/370 version 4.2 or higher must be 
running. 

Registers at call: Return Registers: unknown. 

AX = 7F24h 

other unknown. 

Conflicts: None known. 

INTERRUPT 2Fh - Function 7Fh, Subfunction 24h 

Unknown Function 

Purpose: unknown function called by PC/370. 

Available on: All machines. Restrictions: PC/370 version 4.2 or higher must be 
running. 

Registers at call: Return Registers: unknown. 

AX = 7F26h 

other unknown. 

Conflicts: None known. 

INTERRUPT 60h 

Unknown Function 

Purpose: unknown. 

Available on: All machines. Restrictions: PC/370 version 4.2 or higher must be 
running. ‘ 

Registers at call: unknown. Return Registers: unknown, 


Details: This is the default interrupt, however the documentation includes instructions for patching the system for 
another interrupt. 

Conflicts: See chapter 1. 

See Also: INT 2Fh Function 7Fh Subfunction 24h,INT DCh 


INTERRUPT DCh 

PC/370 v4.1- API 

Purpose: Control the operation of PC/370. 

Available on: All machines. Restrictions: PC/370 version 4.1 or earlier must be 
running, 

Registers at call: uaknown. Return Registers: unknown. 


Conflicts: BASIC interpreter (chapter 1), STSC APL*PLUS/PC (chapter 31). 
See Also: INT 60h 
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Q-PRO4 
INTERRUPT 80h 


Unknown Function 

Purpose: unknown. 

Available on: All machines. Restrictions: Q-PRO4 must be installed. 

Registers at call: unknown. Return Registers: unknown. 

Conflicts: BASIC interpreter (chapter 1), SoundBlaster SBFM driver, QPC Software PKTINT.COM (chapter 27). 


RAID 
RAID (Resident AID) is a TSR utility program by Ross Neilson Wentworth that resides mostly in EMS. It provides a 
clock/calendar, ASCII table, memory dump, file finder, and keyboard scan code display. 


INTERRUPT 2Fh - Function 90h, Subfunction 00h 


INSTALLATION CHECK 

Purpose: Determine whether RAID is installed. 

Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AX = 9000h AL = FFh if installed. 


Conflicts: None known, 


INTERRUPT 2Fh - Function 90h, Subfunction 01h 


GET Unknown Data 

Purpose: unknown. 

Available on: All machines. Restrictions: RAID must be installed. 
Registers at call: Return Registers: 

AX = 9001h DX:AX -> unknown. 


Conflicts: None known. 


INTERRUPT 2Fh - Function 90h, Subfunction 02h 


GET RESIDENT SEGMENT 

Purpose: Determine the address at which RAID was loaded into memory. 

Available on: All machines. Restrictions; RAID must be installed. 
Registers at call: Return Registers: 

AX = 9002h AX = segment of resident code, 


Conflicts: None known. 


INTERRUPT 2Fh - Function 90h, Subfunction 03h 
UNINSTALL 


Purpose: Remove RAID from memory. 

Available on: All machines. Restrictions: RAID must be installed. 
Registers at call: Return Registers: unknown. 

AX = 9003h 

unknown, 

Conflicts: None known. 


INTERRUPT 2Fh - Function 90h, Subfunction 04h 
GET NEXT AVAILABLE MEMORY 


Purpose: Determine the address of the first paragraph of memory beyond the end of RAID's resident portion. 
Available on: All machines. Restrictions: RAID must be installed. 
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Registers at call: Return Registers: 
AX = 9004h AX = segment of first available memory after resident 
portion 
CX destroyed 


Conflicts: None known, 


RESPLAY 
RESPLAY is a freeware sound sampling/playback utility by Mark J. Cox. 


INTERRUPT 2Fh - Function 82h, Subfunction 00h 
SAMPLE/PLAYBACK 


Purpose: Begin sampling sound or playing back previously recorded sound. 


Available on: All machines. Restrictions: RESPLAY must be installed, 
Registers at call: Return Registers: 

AX = 8200h AX = status 

DX:DI -> start of sample space 1000h successful 

CX:BX = length in bytes 2000h not initialized (see Function 82h 


Subfunction 10h) 
other RESPLAY not installed 


Conflicts: None known. 
See Also: Function 82h Subfunctions 01h and 10h 


INTERRUPT 2Fh - Function 82h, Subfunction Oth 


INSTALLATION CHECK 

Purpose: Determine whether RESPLAY has been installed. 

Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 

AX = 8201h AX =7746h if installed 


Conflicts: None known. 
See Also: Function 82h Subfunction 02h 


INTERRUPT 2Fh - Function 82h, Subfunction 02h 
UNINSTALL 


Purpose: Remove RESPLAY from memory. 


Available on: All machines. Restrictions: RESPLAY must be installed, 
Registers at call: Return Registers: 
AX = 8202h AX = status 


1000h successful 


Conflicts: None known. 
See Also: Function 82h Subfunction 01h 


INTERRUPT 2Fh - Function 82h, Subfunction 10h 
INITIALIZE 


Purpose: Specify sample rate, sound device, and whether to sample or replay. 


Available on: All machines. Restrictions: RESPLAY must be installed. 
Registers at call: Return Registers: 
AX = 8210h AX = status 
BL = sound device 1000h successful 
00h printer port LPT1 2000h parameter out of range 
O1h printer port LPT2 other RESPLAY not installed 


02h prototype board at I/O address 0300h 
03h printer port (alternative LPT 1) 
04h internal speaker 


| 
| 
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BH = sample rate in multiples of 250 Hz (14h to 
AOh) 

CL = direction 
00h playback 
Oh sample 

Conflicts: None known. 

See Also: Function 82h Subfunction 00h 


Right-Hand Man 

Right-Hand Man is a TSR desk-top utility by Red E Products, Inc. 

INTERRUPT A4h 

Right Hand Man API 

Purpose: Called by desktop accessories to request services from the resident kernel. 

Available on: All machines. Restrictions: Right Hand Man v3.3 must be installed 
and popped up. 

Registers at call: function number in AH Return Registers: unknown, 


Details: Right-Hand Man only hooks this interrupt while popped up. 
Conflicts: None known. 


SCROLOCK 
SCROLOCK is a utility supplied with System Enhancement Associates’ ARC. 


INTERRUPT 10h - Function 50h 


INSTALLATION CHECK 

Purpose: Determine whether SCROLOCK is installed. 

Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 

AH = 50h BX = 1954h if installed 


AL = 00h if inactive, nonzero if active 
Conflicts: None known. 
See Also: Function 51h 


INTERRUPT 10h - Function 51h 


ENABLE/DISABLE 

Purpose: Specify whether SCROLOCK should be active. 

Available on: All machines. Restrictions; SCROLOCK must be installed. 
Registers at call: Return Registers: n/a 

AH=5lh 


AL = state (00h disable, nonzero enable) 
Conflicts: None known. 
See Also: Function 50h 


SD.COM 


SD.COM is a shareware sorted directory lister by John F. Stetson. 


INTERRUPT 65h 
SD.COM version 6.2 


Purpose: Maintain a count of the number of uses. 

Available on: All machines. Restrictions: none. 

Details: The unregistered version of SD62.COM uses the low byte of this vector to count the number of invocations, 
displaying a registration reminder each time after the 20th use. 

Conflicts: See chapter 1. 
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Soft-ICE 
Nu-Mega Technologies's Soft-ICE is an 80386 systems debugger which runs the debugger in protected mode, 


permitting recovery from otherwise fatal program crashes. 


INTERRUPT 03h - Function 4647h 
Soft-ICE BACK DOOR COMMANDS 


Purpose: Control the Soft-ICE debugging system. 


Available on: All machines. Restrictions: Soft-ICE must be installed. 
Registers at call: Return Registers: 
AH = 09h 


SI = 4647h (‘FG’) 
DI = 4A4Dh (‘JM’) 
AL = function 
10h display string in Soft-ICE window nfa 
DS:DX -> ASCIZ string to display (max 
100 bytes, 0Dh OK) 
{1h execute Soft-ICE command na 
DS:DX -> ASCIZ command string (max 
100 bytes, ODh OK) 
12h get breakpoint information BH = entry number of last breakpoint set 
BL = type of last breakpoint set 
00h BPM (breakpoint register types) 
Olh 1/0 
02h INTerrupt 
03h BPX (INT 03h-style breakpoint) 
04h reserved 
OSh range 
DH = entry number of last breakpoint to be triggered 
DL = type of last triggered breakpoint (see above) 
Conflicts: None known. 


SoundBlaster SBFM Driver 
INTERRUPT 80h - Function 0000h 


GET VERSION 

Purpose: Determine which version of the SBFM driver is installed. 

Available on: All machines. Restrictions: SoundBlaster SBFM driver must be 
installed. 

Registers at call: Return Registers: unknown, 

BX = 0000h 


Details: SBFM installs at the first free interrupt in the range 80h through BFh. 
Conflicts: Q-PRO4, BASIC interpreter (chapter 1), QPC Software PKTINT.COM (chapter 27). 
See Also: Function 0008h 


INTERRUPT 80h - Function 0001h 
SET MUSIC STATUS BYTE ADDRESS 


Purpose: Specify the location to update whenever the music status changes. 


Available on: All machines. Restrictions: SoundBlaster SBFM driver must be 
installed. 

Registers at call: Return Registers: n/a 

BX = 000Ih 


DX:AX -> music status byte 
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Conflicts: Q-PRO4, BASIC interpreter (chapter 1), QPC Software PKTINT.COM (chapter 27). 
See Also: Functions 0000h, 0002h, and 0003h 


INTERRUPT 80h - Function 0002h 


SET INSTRUMENT TABLE 

Purpose: Specify the instrument setup of the sound board. 

Available on: All machines. Restrictions: SoundBlaster SBFM driver must be 
installed. 

Registers at call: Return Registers: n/a 

BX = 0002h 


CX = number of instruments 

DX:AX -> instrument table 

Conflicts: Q-PRO4, BASIC interpreter (chapter 1), QPC Software PKTINT.COM (chapter 27). 
See Also: Functions 0000h, 0001h, and 000S5h 


INTERRUPT 80h - Function 0003h 


SET SYSTEM CLOCK RATE 

Purpose: Specify the rate of the system clock, used to time sounds, 

Available on: All machines. Restrictions: SoundBlaster SBFM driver must be 
installed, 

Registers at call: Return Registers: n/a 

BX = 0003h 


AX = clock rate divisor (1193180 / desired 
frequency in Hertz) 
FFFFh to restore to 18.2 Hz 
Conflicts: Q-PRO4, BASIC interpreter (chapter 1), QPC Software PKTINT.COM (chapter 27). 
See Also: Functions 0000h, 0001h, and 0004h 


INTERRUPT 80h - Function 0004h 
SET DRIVER CLOCK RATE 


Purpose: Specify the rate of the driver's clock. 
Available on: All machines. Restrictions: SoundBlaster SBFM driver must be 
installed. 
Registers at call: Return Registers: n/a 
BX = 0004h 
AX = driver clock rate divisor (1193180 / frequency 
in Hertz) 
Details: The default frequency is 96 Hz. 
Conflicts: Q-PRO4, BASIC interpreter (chapter 1), QPC Software PKTINT.COM (chapter 27). 
See Also: Functions 0000h and 0003h 


INTERRUPT 80h - Function 0005h 


TRANSPOSE MUSIC 

Purpose: Change the overall pitch of the music being played. 

Available on: All machines. Restrictions: SoundBlaster SBFM driver must be 
installed. 

Registers at call: Return Registers: n/a 

BX = 0005h 


AX = semi-tone offset 
Conflicts: Q-PRO4, BASIC interpreter (chapter 1), QPC Software PKTINT.COM (chapter 27). 
See Also: Functions 0000h, 0002h, and 0006h 
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INTERRUPT 80h - Function 0006h 


PLAY MUSIC 

Purpose: Begin playing the specified music. 

Available on: Ali machines. Restrictions: SoundBlaster SBFM driver must be 
installed. 

Registers at call: Return Registers: 

BX = 0006h AX = status 

DX:AX -> music block 0000h successful 


0001h music already active 
Conflicts: Q-PRO4, BASIC interpreter (chapter 1), QPC Software PKTINT.COM (chapter 27). 
See Also: Functions 0000h, 0007h, and 0OOAh 


INTERRUPT 80h - Function 0007h 


STOP MUSIC 
Purpose: Halt the currently-playing music and discard any remaining notes. 
Available on: Ali machines. Restrictions: SoundBlaster SBFM driver must be 
installed. 
Registers at call: Return Registers: 
BX = 0007h AX = status 
0000h successful 


0001h music not active 
Conflicts: Q-PRO4, BASIC interpreter (chapter 1), QPC Software PKTINT.COM (chapter 27). 
See Also: Functions 0000h, 0006h, and 0009h 


INTERRUPT 80h - Function 0008h 


RESET DRIVER 
Purpose: Place the driver into a known initial state. 
Available on: All machines, Restrictions: SoundBlaster SBFM driver must be 
installed. 
Registers at call: Return Registers: 
BX = 0008h AX = status 
0000h successful 


0001h music is active 
Conflicts: Q-PRO4, BASIC interpreter (chapter 1), QPC Software PKTINT.COM (chapter 27). 
See Also: Function 0000h 


INTERRUPT 80h - Function 0009h 


PAUSE MUSIC 
Purpose: Temporarily stop playing the current music. 
Available on: All machines. Restrictions: SoundBlaster SBFM driver must be 
installed. 
Registers at call: Return Registers: 
BX = 0009h AX = status 
0000h successful 


0001h no music active 
Conflicts: Q-PRO4, BASIC interpreter (chapter 1), QPC Software PKTINT.COM (chapter 27). 
See Also: Functions 0000h, 0007h, and O00OAh 


INTERRUPT 80h - Function 000Ah 
RESUME MUSIC 


Purpose: Restart the music after a temporary stop. 
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Available on: All machines. Restrictions: SoundBlaster SBFM driver must be 
installed. 
Registers at call: Return Registers: 
BX = 000Ah AX = status 
0000h successful 


0001h no music paused 
Conflicts: Q-PRO4, BASIC interpreter (chapter 1), QPC Software PKTINT.COM (chapter 27). 
See Also: Functions 0000h, 0006h, and 0009h 


INTERRUPT 80h - Function 000Bh 
SET USER-DEFINED TRAP FOR SYSTEM-EXCLUSIVE COMMANDS 


Purpose: Specify the handler to be invoked on system-exclusive commands. 


Available on: All machines. Restrictions: SoundBlaster SBFM driver must be 
installed. 

Registers at call: Return Registers: n/a 

BX = 000Bh 


DX:AX -> trap routine 
Conflicts: Q-PRO4, BASIC interpreter (chapter 1), QPC Software PKTINT.COM (chapter 27). 
See Also: Function 0000h 


SPEECH.COM 


There are two different resident text-to-speech converters available under the name SPEECH.COM, The first is by 


Andy C. McGuire (SPEECH.COM and SAY.COM), the other is by Douglas Sisco. 


INTERRUPT Fih 
CONVERT TEXT STRING TO SPEECH 


Purpose: Output the supplied string through the system's speaker as speech. 


Available on: All machines. Restrictions: Douglas Sisco’s SPEECH.COM must be 
installed. 
Registers at call: Return Registers: unknown. 


DS:BX -> '$'-terminated text string 
Conflicts: McGuire's SPEECH.COM. 


INTERRUPT Fih 

Unknown Function 

Purpose: unknown, 

Available on: All machines. Restrictions: Andy 
SPEECH.COM/SAY.COM 
installed. 

Registers at call: unknown. Return Registers: unknown. 

Conflicts: Sisco's SPEECH.COM. 

INTERRUPT F2h 

Unknown Function 

Purpose: wiknown. 

Available on: All machines. Restrictions: Andy 
SPEECH,COM/SAY.COM 
installed. 

Registers at call: unknown. Return Registers: unknown. 


Conflicts: None known. 


McGuire's 
must be 


McGuire's 
must be 
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SPEEDSCR.COM , 
SPEEDSCR.COM is a video speedup utility by The Software Bottling Co. 


INTERRUPT 17h - Function 61h 


INSTALLATION CHECK 

Purpose: Determine whether SPEEDSCR.COM is present. 

Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AH = 61h AL = 6th 


DX =CS of resident code 
Conflicts: None known. 


SQL Base 


SOL Base is a network-oriented database engine by Gupta Technologies. 


INTERRUPT 47h - Function 80h, Subfunction 00h 


DATABASE ENGINE API 

Purpose: Invoke the SQL Base database engine. 

Available on: All machines. Restrictions: SQL Base must be installed. 
Registers at call: Return Registers: n/a 

AX = 8000h 


DS:BX -> parameter block, first word is function 
number (Table 36-19) 
Conflicts: None known. 


Table 36-19. Values for SOL Base Function Number: 





Value Name Meaning 

Oth "SQLFINI" initialize application's use of the database 
02h "SQLFDON" application is done using the database 

03h "SQLFCON" connect to a cursor/database 

04h "SQLFDIS" disconnect from a cursor/database 

05h "SQLFCOM" compile a SQL command 

06h "SQLFEXE” execute a SQL command 

07h "SQLFCEX" compile and execute a SQL command 

08h "SQLFCMT" commit a transaction to the database 

09h "SQLFDES" describe the items of a SELECT statement 
OAh "SQLFGFI" get fetch information 

OBh "SQLFFBK" fetch previous result row from SELECT statement 
0Ch “SQLFFET" etch next result row from SELECT statement 
ODh “SQLFEFB" enable fetch backwards 

QEh "SQLFPRS" position in result set 

OFh “SQLFURS" undo result set 

10h "SQLFNBV" get number of bind variables 

lih “SQLFBND” bind data variables 

12h "SQLFBNN" bind numerics 

13h "SQLFBLN" bind long number 

14h "SQLFBLD" bind long data variables 

15h "SQLFSRS" start restriction set processing 

16h "SQLFRRS" restart restriction set processing 

17h "SQLFCRS" close restriction set 

18h "SQLFDRS" drop restriction set 

19h "SQLFARE" apply Roll Forward journal 

1Ah "SQLFERF" end Roll Forward journal 


1Bh "SQLFSRE" start Roll Forward journal 
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Table 36-19. Values for SOL Base Function Number (continued) 


Value 
iCh 
1Dh 
tEh 
1FI 
20h 
21h 
22h 
23h 
24h 
25) 
26) 
27 
28h 
29h 
2A 
2Bh 
2C) 
2D) 
2E 
2Fh 
301 
31 
32] 
33 
34] 
35 
36h 
37h 
38h 
39) 
3Ah 
3Bh 
3Ch 
3Dh 
3Eh 
3Fh 
40h 

4ih 

42h 

43h 

44h 

45h 

46h 

47h 

48h 

49h 

4Ah 
4Bh 
4Ch 
4Dh 
4Eh 
4Fh 
50h 

51h 

52h 

53h 

54h 


> 


SS 


so S 








Name 
"SQLFSTO" 
“SQLFRET" 
"SQLFEDST" 
"SQLFCTY" 
"“SQLFEPO" 
"“SQLFGNR" 
"SQLENSI" 
"SQLFRBF" 
"SQLFRCD" 
"SQLFROW" 
"SQLFSCN" 


Meaning 

store a compiled SQL command 
retrieve a compiled SQL command 
drop a stored command 

get command type 

get error position 

get number of rows 

get number of select items 

get Roll Back flag 

get return code 

get number of ROWs 

set cursor name 


"SQLFSIL" set isolation level 
"SQLFSLP" set log parameters 
"SQLFSSB'"set select buffer 
"SQLFSSS" set sort space 


"“SQLFRLO" 
“SQLFWLO” 
"SQLFLSK" 
"SQLFGLS" 
"SQLFELO" 
"SOLERBK" 
"SQLFERR" 
"SQLFCPY" 
"SQLFRO1" reserved 
"SQLFSYS" 
"SQLFSTA" 
"SQLFRO2" reserved 
"SQLFXAD" 
"SQLFXCN" 
"SQLFXDA" 
"SQLFXDP" 
"SQLFXDV" 
"SQLEXML" 
"SQLFXNP" 
"SQLFXPD" 
“SQLFXSB" 





read long 

rite long 

long seek 

get long size 

end long operation 

roll back a transaction from the database 
error message 

copy 


system 
Statistics 


extra add 

extra character to number 
extra date add 

extra date picture 

extra divide 

extra multiply 

extra number picture 
extra picture date 

extra subtract 


"SQLFINS" install database 


"SQLFDIN" 


deinstall database 


"SQLFDIR" directory of databases 


"SQLFTIO" timeout 
"SQLFFQN" 
"SQLFEXP" 
"SQLFFER" 
"SOLFBKP" 
"SQLFRDC" 
"SQLFEBK" 
"SQLFRES" 
"SOLFWDC" 
"SQLFRRD" 
"SQLFERS" 
"SQLFNRR" 
"SQLFSTR" 
"SQLFSPR" 
“SQLFCNC" 
"SOLFCNR" 
"SQLFOMS" 
"SQLFIMS" 


get fully qualified column name 
explain execution plan 

get full error 

begin online backup 

read backup data chunk 

end backup 

begin restore from backup 

write backup data chunk for restore 
recover restored database to consistent state 
end restore 

return number of result set rows 
start restriction mode 

stop restriction mode 

connect 2 

connect with no recovery 

set output message size 

set input message size 
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Table 36-19. Values for SQL Base Function Number (continued) 


Value Name Meaning 

55h “SQLFSCP" set cache pages 

56h "SQLFDSC" describe items of a SELECT statement (external) 

57h "SQLFLAB" get label info for items in SELECT statement 

58h "SQLFCBV" clear bind variables 

59h "SQLFGET" get database information 

SAh "SQLFSET" set database information 

SBh "SQLFTEC" translate error code 

INTERRUPT 47h - Function 80h, Subfunction 01h 

GET VERSION NUMBER 

Purpose: Determine which version of SQL Base is installed. 

Available on: All machines. Restrictions: SQL Base must be installed. 
Registers at call: Return Registers: unknown, 
AX = 8001h 


Conflicts; None known. 


Microsoft SQL Server/Sybase DBLIBRARY interface 


These two products use INT 62h; no further information was available at the time of writing. 


MicroHelp Stay-Res Plus 
MicroHelp's Stay-Res and Stay-Res Plus are wrappers which allow an ordinary non-resident program to be converted 
into a TSR with minimal changes. 

Programs which use Stay-Res include ThesPlus (internal program identifier "THESPLUS") and Personal 
Calendar (internal program identifier "CAL") by Paul Mufioz-Colman, 


INTERRUPT 66h - Function FFh, Subfunction FBh 


Unknown Function 

Purpose: unknown. 

Available on: All machines. Restrictions: Program built with MicroHelp Stay-Res 
Plus must be installed. 

Registers at call: Return Registers: unknown. 

AX = FFFBh 

BX = FFFBh 


others, if any, unknown. 

Conflicts: Data General DG10 MicroECLIPSE coprocessor interface (chapter 1), The IBM Digitized Sound 
Package; see also chapter 1. 

See Also: Function FFh Subfunction FEh 


INTERRUPT 66h - Function FFh, Subfunction FEh 


UNINSTALL 

Purpose: Remove the program created with Stay-Res from memory. 

Available on: All machines, Restrictions: Program built with MicroHelp Stay-Res 
or Stay-Res Plus must be installed, 

Registers at call: Return Registers: 

AX = FFFEh only returns if unsuccessful 

BX = FFFEh 


Details: The installation check is for the interrupt handler to begin with the bytes FBh 9Ch or 9Ch FAh, and the 
program name (not case-sensitive) to appear at offset 000Sh (older versions) or the offset returned by Function FFh 
Subfunction FFh/BX=FFFOh in the interrupt handler segment. 

onflicts: Data General DG10 (Chapter 1), The IBM Digitized Sound Package; see also chapter 1. 

See Also: Function FFh Subfunctions FBh and FFh 


| 
H 
| 
| 
i 
i 
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INTERRUPT 66h - Function FFh, Subfunction FFh 


FIND PROGRAM NAME 

Purpose: Determine the address of the program identifier within the program created using Stay-Res Plus. 

Available on: All machines, Restrictions: Program built with MicroHelp Stay-Res 
Plus must be installed. 

Registers at call: Return Registers: 

AX = FFFFh DI = offset of program name in interrupt handler 

BX = FFFOh segment 


Conflicts: Data General DG10 MicroECLIPSE coprocessor interface (chapter 1), The IBM Digitized Sound 
Package; see also chapter 1. 
See Also: Function FFh Subfunctions FBh and FEh 


SWAP Utilities 
The SWAP Utilities by Innovative Data Concepts are a series of shareware programs which significantly reduce the 
amount of memory taken by a number of popular but large TSR programs (SideKick, Tornado Notes, Lotus Metro, 
PC Tools Shell and Desktop, The Norton Guides, etc.). These programs can be swapped to disk, EMS, or XMS 
rather than taking up main memory. In addition, the SWAP utilities allow the hotkey to be changed on all of the 
supported programs, even those which normally have fixed hotkeys. 

Central Point Software has licenced SWAPDT.COM and SWAPSH.COM (version 1.77j) for inclusion with PC 
Tools version 7.0. 


INTERRUPT 16h - Function 55h, Subfunction FFh 


Unknown Function 

Purpose: unknown. 

Available on: All machines. Restrictions: SWAPDT.COM or SWAPSH.COM 
version 1.77j must be installed. 

Registers at call: Return Registers: n/a 

AX = 55FFh 

BX >= 0004h 


CX = subfunction 
0000h set unknown flag 
other clear unknown flag 
Conflicts: None known. 


SWELL (SWapping shELL) 
SWELL.EXE is a shareware TSR by Peter Fitzsimmons which swaps programs to disk when they EXEC a child 
process with INT 21h Function 4Bh (chapter 8). 


INTERRUPT 2Fh - Function CDh, Subfunction 00h 


INSTALLATION CHECK 

Purpose: Determine whether SWELL.EXE is installed. 

Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AX = CD00h AX = OOFFh installed 


BH = major version 
BL = minor version 
Conflicts: Intel Image Processing Interface (chapter 30). 


INTERRUPT 2Fh - Function CDh, Subfunction 01h 


SUSPEND ONCE 


Purpose: Specify that the next DOS EXEC function call should be ignored. 
Available on: All machines. Restrictions: SWELL.EXE must be installed. 
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Registers at call: Return Registers: 
AX = CDO1h AX = 0000h 
Conflicts: Intel Image Processing Interface (chapter 30). 

See Also: Function CDh Subfunction 02h 


INTERRUPT 2Fh - Function CDh, Subfunction 02h 
SUSPEND 


Purpose: Specify that SWELL should not swap out programs calling the DOS EXEC function. 


Available on: All machines. Restrictions: SWELL.EXE must be installed. 
Registers at call: Return Registers: 
AX = CD02h AX = 0000h 


Conflicts: Intel Image Processing Interface (chapter 30). 
See Also: Function CDh Subfunction 03h 


INTERRUPT 2Fh - Function CDh, Subfunction 03h 
ACTIVATE 


Purpose: Allow SWELL to swap out programs calling the DOS EXEC function. 


Available on: All machines. Restrictions: SWELL.EXE must be installed. 
Registers at call: Return Registers: 
AX = CD03h AX = 0000h 


Conflicts: Intel Image Processing Interface (chapter 30). 
See Also: Function CDh Subfunction 02h 


INTERRUPT 2Fh - Function CDh, Subfunction 04h 
TURN OFF VERBOSE MODE 


Purpose: Specify that SWELL should be silent when swapping programs out of memory. 


Available on: All machines. Restrictions: SWELL.EXE must be installed. 
Registers at call: Return Registers: 
AX =CD04h AX = 0000h 


Conflicts: Intel Image Processing Interface (chapter 30). 
See Also: Function CDh Subfunction 05h 


INTERRUPT 2Fh - Function CDh, Subfunction 05h 
TURN ON VERBOSE MODE 


Purpose: Allow SWELL to report on the programs it swaps out of memory, 


Available on: All machines. Restrictions; SWELL.EXE must be installed. 
Registers at call: Return Registers: 
AX =CD05h AX = 0000h 


Conflicts: Intel Image Processing Interface (chapter 30). 
See Also: Function CDh Subfunction 04h 


INTERRUPT 2Fh - Function CDh, Subfunction 06h 
UNINSTALL 


Purpose: Remove SWELL.EXE from memory. 


Available on: All machines. Restrictions: SWELL.EXE must be installed. 
Registers at call: Return Registers: 
AX = CDOGh AX = 0000h uninstalled 


8002h programs still swapped, not uninstalled 


Conflicts: Intel Image Processing Interface (chapter 30). 
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INTERRUPT 2Fh - Function CDh, Subfunction 07h 


GET INFO 
Purpose: Determine the current settings for SWELL. 
Available on: All machines. Restrictions: SWELL.EXE must be installed. 
Registers at call: Return Registers: 
AX =CDO7h AX = 0000h successful 
ES:BX -> 32-byte buffer for info (Table 36-20) ES:BX buffer filled 
8001h buffer wrong size 
Conflicts: Intel Image Processing Interface (chapter 30). 
Table 36-20. Format of Info Buffer: 
Offset Size Description 
00h WORD 20h (total size of buffer) 
02h BYTE suspend-once mode active if nonzero 
03h BYTE 00h active, 01h suspended 
04h BYTE 00h quiet, 01h verbose 
05h BYTE “Borland support” (allowing INT 21h Function 4Bh Subfunction 01h) on if nonzero 
06h 26BYTEs apparently unused 
INTERRUPT 2Fh - Function CDh, Subfunction 08h 
UNUSED 
Purpose: This function is not used and should not be called. 
Available on: All machines. Restrictions: SWELL.EXE must be installed. 
Registers at call: Return Registers: 
AX = CDO08h AX = FFFFh (error) 


Conflicts: Intel Image Processing Interface (chapter 30), 


INTERRUPT 2Fh - Function CDh, Subfunction 09h 
SWELL.EXE - TURN OFF "BORLAND SUPPORT" 


Purpose: Disable SWELL from responding to INT 21h Function 4Bh Subfunction 01h, an undocumented DOS call 
used by several Borland products. This is the default state. 


Available on: All machines. Restrictions: SWELL.EXE must be installed. 
Registers at call: Return Registers: 
AX = CD09h AX = 0000h 


Conflicts; Intel Image Processing Interface (chapter 30). 
See Also: Function CDh Subfunction 0Ah 


INTERRUPT 2Fh - Function CDh, Subfunction OAh 
SWELL.EXE - TURN ON "BORLAND SUPPORT" 


Purpose: Permit SWELL to respond to INT 21h Function 4Bh Subfunction 01h, an undocumented DOS call used by 
several Borland products, 


Available on: All machines, Restrictions: SWELL.EXE must be installed. 
Registers at call: Return Registers: 
AX =CDOAh AX = 0000h 


Conflicts: Intel Image Processing Interface (chapter 30). 
See Also: Function CDh Subfunction 09h 


SYS_PROF 
SYS_PROF,EXE is the TSR portion of a system profiler from Micro Cornucopia magazine, issue #47. 


| 
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INTERRUPT 60h - Function 00h 


PROFILER STATUS 

Purpose: Determine whether profiling is currently turned on. 

Available on: All machines. Restrictions: SYS_PROF.EXE must be installed. 
Registers at call: Return Registers: 

AH = 00h AX=0000h profiling is off 


otherwise profiling is on 
Conflicts: See chapter 1. 
See Also: Functions 01h and 02h 


INTERRUPT 60h - Function 01h 


TURN PROFILING OFF 

Purpose: Stop recording the time spent in various interrupt calls. 

Available on: All machines. Restrictions: SYS_PROF.EXE must be installed. 
Registers at call: Return Registers: n/a 

AH=0th 


Conflicts: See chapter 1. 
See Also: Functions 00h and 02h 


INTERRUPT 60h - Function 02h 


TURN PROFILING ON 

Purpose: Begin recording the number of calls to various interrupt functions and the total times spent in each. 
Available on: All machines, . Restrictions: SYS_PROF.EXE must be installed, 
Registers at call: Return Registers: n/a 

AH = 02h 


Conflicts: See chapter I. 
See Also: Functions 00h, and 01h 


INTERRUPT 60h - Function 03h 
GET ADDRESS OF PROFILING TABLE 


Purpose: Determine the address of the profiling results. 


Ayailable on: All machines. Restrictions: SYS_PROF.EXE must be installed. 
Registers at call: Return Registers: 
AH = 03h ES:BX -> profiling table 


Details: The format of the profiling table depends on how many functions of each interrupt are being profiled; this 
varies in different tweaked versions which are available. 

Conflicts: See chapter |. 

See Also: Function 04h 


INTERRUPT 60h - Function 04h 
CLEAR PROFILING TABLE 


Purpose: Reset all counts of interrupt calls and times to zero. 

Available on: All machines. Restrictions; SYS_PROF,EXE must be installed, 
Registers at call: Return Registers: n/a 

AH = 04h 

Conflicts: See chapter 1. 

See Also: Function 03h 


TAME 
TAME is a shareware program by David G. Thomas which gives up CPU time to other partitions under a multitasker 
when the current partition's program incessantly polls the keyboard or system time. 
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INTERRUPT 21h - Function 2Bh, Subfunction 01h 


INSTALLATION CHECK 

Purpose: Determine whether TAME version 2.10 or higher is installed. 

Available on: All machines. Restrictions: none. 

Registers at call: Return Registers: 

AX =2B0th AL = 02h if installed 

CX = 5441h (TA') ES:DX -> data area in TAME-RES (Tables 36-21 
DX = 4D45h (‘ME}) thru 36-23) 

---V2,60--- 


BH =00h skip unknown, 

else do unknown. 
Conflicts: PC Tools v5.1 PC-CACHE (chapter 6), DOS 1+ Set System Date (chapter 8), DESQview (chapter 15), 
peANYWHERE IV (chapter 28), ELRES v1.1. 


Table 36-21, Format of TAME 2.10-2.20 Data Area: 


Offset Size Description 
00h BYTE data structure minor version number (01h in TAME 2.20) 
Olh BYTE data structure major version number (07h in TAME 2.20) 
02h DWORD _ number of task switches 
06h DWORD number of keyboard polls 
OAh DWORD _ number of time polls 
OEh DWORD number of times DESQview told program runs only in foreground 
12h DWORD _ original INT 10h 
16h DWORD _ original INT 14h 
1Ah DWORD _ original INT 15h 
1Eh DWORD _ original INT 16h 
22h DWORD _ original INT 17h 
26h DWORD _ original INT 21h 
2Ah DWORD _ original INT 28h 
2Eh WORD offset of TAME INT 10h handler 
30h WORD offset of TAME INT 14h handler 
32h WORD offset of TAME INT 15h handler 
34h WORD offset of TAME INT 16h handler 
36h WORD offset of TAME INT 17h handler 
38h WORD offset of TAME INT 21h handler 
3Ah WORD offset of TAME INT 28h handler 
3Ch WORD X in /max:X,Y or /freg:X,Y 
3Eh WORD Y in /max:X,Y or /freq:X,Y 
40h WORD number of polls remaining before next task switch 
42h WORD /KEYIDLE value 
44h BYTE flags for interrupts already grabbed by TAME: 
bit 0: INT 10h 
1: INT 14h 
2: INT 15h 
3: INT 16h 
4: INT 17h 
SINT 21h 
6: INT 28h 
45h BYTE flags for interrupts which may be acted on (same bits as above) 
46h BYTE TAME enabled (01h) or disabled (00h) 
47h BYTE /TIMEPOLL (01h) or /NOTIMEPOLL (00h) 
48h BYTE /NOTIMER (01h) or /TIMER (00h) 


49h BYTE window or task number for this task 
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Table 36-21. Format of TAME 2.10-2.20 Data Area (continued) 





Offset Size 

4Ah BYTE 
4Bh BYTE 
4Ch BYTE 
4D) BYTE 
4E BYTE 
4Fh BYTE 
50h BYTE 


Description 
multitasker type 
O1h DESQview 
02h DoubleDOS 
03h TopView 
unknown, 
type of task switching selected: 
bit 0: DESQview 
1: DoubleDOS 
2: TopView 
3: KeySwitch 
4: HLT instruction 
unknown. 
flags: bit 1: /FREQ instead of /MAX 
/FG: value 
task switches left until next FGONLY DESQview API call 
unknown, 


Table 36-22. Format of TAME 2.30 data area: 





Offset Size 

00h BYTE 
01 BYTE 
02h DWORD 
06) DWORD 
OAh DWORD 
OEh DWORD 
12h DWORD 
16) DWORD 
1Ah DWORD 
1Eh DWORD 
22h DWORD 
26h DWORD 
2Ah DWORD 
2Eh DWORD 
32h DWORD 
36h DWORD 
3Ah DWORD 
3Eh WORD 
40h WORD 
42h WORD 
44h WORD 
46h WORD 
48h WORD 
4Ah WORD 
4Ch WORD 
4Eh WORD 
50h WORD 
52h WORD 
54h WORD 
56h WORD 
58h WORD 
SAh WORD 


Description 

data structure minor version number (02h in TAME 2,30) 
data structure major version number (OAh in TAME 2.30) 
number of task switches 

number of keyboard polls 

number of time polls 

number of times DESQview told program runs only in foreground 
time of last CLEAR or TAME-RES load 

time yielded 

time spent polling 

time spent waiting on key input with INT 16h Functions 01h,!1h (chapter 3) 
original INT 10h 

original INT 14h 

original INT 15h 

original INT 16h 

original INT 17h 

original INT 21h 

original INT 28h 

offset of TAME INT 10h handler 

offset of TAME INT 14h handler 

offset of TAME INT 15h handler 

offset of TAME INT 16h handler 

offset of TAME INT 17h handler 

offset of TAME INT 21h handler 

offset of TAME INT 28h handler 

X in /max:X,¥ or /freq:X,Y 

Y in fmax:X,¥Y or /freq:X,Y 

number of polls remaining before next task switch 
/KEYIDLE value 

/FG: value 

task switches left until next FGONLY DESQview API call 
multitasker version 

virtual screen segment 
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Table 36-22. Format of TAME 2.30 data area (continued) 


Offset 
5Ch 


5Dh 
SEh 
5Fh 


60h 


6th 
62h 


63h 
64h 


Table 36-23. 


Offset 
00h 
Oth 
02h 
06h 
QAh 





Size 
BYTE 


BYTE 
BYTE 
BYTE 


BYTE 


BYTE 
BYTE 


BYTE 
WORD 


Description 
flags for interrupts already grabbed by TAME: 
bit 0: INT 10h 
1: INT 14h 
2: INT 15h 
3: INT 16h 
4: INT 17h 
5: INT 2th 
6: INT 28h 
flags for interrupts which may be acted on (same bits as above) 
window or task number for this task 
multitasker type: 
Olh DESQview 
02h DoubleDOS 
03h TopView 
04h OmniView 
05h VM/386 
type of task switching selected (bit flags): 
bit 0: DESQview 
1: DoubleDOS 
2: TopView 
3: OmniView 
4: KeySwitch 
5: HLT instruction 
watch_DOS 
bit flags: 
bit 0: TAME enabled 
1: /FREQ instead of /MAX (counts in 3Ch and 3Eh per tick) 
2: /TIMEPOLL, 
3: /KEYPOLL 
4: inhibit timer 
5; enable status monitoring 
old status 
signature DA34h 


Format of TAME 2.60 data area: 


Size 
BYTE 
BYTE 
DWORD 
DWORD 
DWORD 
DWORD 
DWORD 
DWORD 
DWORD 
DWORD 
4 BYTEs 
DWORD 
DWORD 
DWORD 
DWORD 
DWORD 
DWORD 
DWORD 
WORD 


Description 

data structure minor version number (02h in TAME 2.60) 

data structure major version number (OBh in TAME 2.60) 
number of task switches 

number of keyboard polls 

number of time polls 

number of times DESQview told program runs only in foreground 
time of last (CLEAR or TAME-RES load 

time yielded 

time spent polling 

time spent waiting on key input with INT 16h Function O1h,11h (chapter 3) 
unknown, 

original INT 10h 

original INT 14h 

original INT 15h 

original INT 16h 

original INT 17h 

original INT 21h 

original INT 28h 

offset of TAME INT 10h handler 
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Table 36-23. Format of TAME 2.60 Data Area (continued) 








Offset Size Description 
44h WORD offset of TAME INT 14h handler 
46h WORD offset of TAME INT 15h handler 
48h WORD offset of TAME INT 16h handler 
4Ah WORD offset of TAME INT [7h handler 
4Ch WORD offset of TAME INT 21h handler 
4Eh WORD offset of TAME INT 28h handler 
50h WORD X in /max:X,Y or /freq:X,Y 
52h WORD Y in /max:X,Y or /freq:X,Y 
54h WORD number of polls remaining before next task switch 
56h WORD /KEYIDLE value 
38h 4BYTEs unknown. 
5Ch WORD X in /boost:X,Y 
SEh WORD Y in /boost:X,Y 
60h WORD /FG: value 
62h WORD task switches left until next FGONLY DESQview API call 
64h WORD multitasker version 
66h WORD virtual screen segment 
68h BYTE flags for interrupts already grabbed by TAME: 
bit 0: INT 10h 
1: INT 14h 
2: INT 15h 
3: INT 16h 
4: INT 17h 
5: INT 21h 
6: INT 28h 
69h BYTE flags for interrupts which may be acted on (same bits as above) 
6Ah BYTE window or task number for this task 
6Bh BYTE multitasker type: 
Olh DESQview 
02h DoubleDOS 
03h TopView 
04h OmniView 
05h VM/386 
6Ch BYTE type of task switching selected (bit flags): 


bit 0: DESQview 
1: DoubleDOS 
2: TopView 
3: OmniView 
4: KeySwitch 
5: HLT instruction 
6Dh BYTE watch, DOS 
6Eh BYTE bit flags: 
bit 0: TAME enabled 
1: /FREQ instead of /MAX (counts in 50h and 52h per tick) 
2: /TIMEPOLL 
3: /KEYPOLL 
4: inhibit timer 
5: enable status monitoring 
6Fh BYTE old status 
70h WORD signature DA34h 


Tandy SCHOOLMATE Plus 


INTERRUPT 6Bh - Function 6Bh 
SCHOOLMATE API 


Purpose: Communicate with the SCHOOLMATE Plus program. 
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Available on: Tandy systems. Restrictions: SCHOOLMATE Plus must be present. 
Registers at call: Return Registers: varies 
AH = 6Bh 


AL = E0h to FFh 
Conflicts: None known. 


TesSeRact RAM-RESIDENT PROGRAM INTERFACE 

The TesSeRact RAM-resident program interface is a standardized method for assuring compatibility between TSRs. 
The standard was created by a group of independent TSR developers (which included one of the authors of this 
volume) and is freely distributed; any TSR designer is encouraged to comply with the standard in order to maximize 
compatibility with other programs. The leader of the TesSeRact Development Team, Innovative Data Concepts, 
publishes a shareware development library which implements the standard, but use of this library is not necessary for 
a program to qualify as TesSeRact-compliant. 


INTERRUPT 2Fh - Function 5453h, Subfunction 00h 


INSTALLATION CHECK 

Purpose: Determine whether the specified TesSeRact-compliant TSR is present in the system. 

Available on: All machines, Restrictions: none. 

Registers at call; Return Registers: 

AX = 5453h AX = FFFFh installed 

BX = 00h CX = ID number of already-installed copy 
DS:SI -> 8-char blank-padded name anything else, not installed 


CX = ID number for TSR when installed 
Details: Borland's THELP.COM popup help system for Turbo Pascal, Turbo C, and Turbo Assembler fully supports 
the TesSeRact API, as do the SWAP?? programs by Innovative Data Concepts. 
AVATAR.SYS supports functions 00h and 01h (only the first three fields of the user parameter block) using the 
name "AVATAR " (note the two trailing blanks, which are required). 
Conflicts: None known. 


INTERRUPT 2Fh - Function 5453h, Subfunction 01h 
GET USER PARAMETERS 


Purpose: Retrieve a data block indicating which functions are supported, which hotkeys are being used, and other 

TSR data. 

Available on: All machines. Restrictions: TesSeRact-compliant TSR must be 
present in system for return to be valid; 
else error code will be returned. 


Registers at call: Return Registers: 

AX = 5453h AX = 0000h successful 

BX =0ih ES:BX -> user parameter block (Table 36-24) 
CX = TSR ID number nonzero failed 


Conflicts: None known. 


Table 36-24. Format of TesSeRact User Parameter Block: 


Offset Size Description 

00h 8BYTEs _ blank-padded TSR name; all 8 bytes must be used 
08h WORD TSR ID number 

OAh DWORD bitmap of supported functions 

QOEh BYTE scan code of primary hotkey: 


00h = pop up when shift states match 

FFh = no popup (if shift state also FFh) 
OFh BYTE shift state of primary hotkey, FFh = no popup (if scan code also FFh) 
10h BYTE number of secondary hotkeys 
1ih DWORD pointer to extra hotkeys set by func 05h 
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Table 36-24. Format of TesSeRact User Parameter Block (continued) 


Offset Size Description 

15h WORD current TSR status flags 
17h WORD PSP segment of TSR 
19h DWORD DTA for TSR 

1Dh WORD default DS for TSR 

1Fh DWORD stack at popup 

23h DWORD _ stack at background invocation 

INTERRUPT 2Fh - Function 5453h, Subfunction 02h 

CHECK IF HOTKEY IN USE 

Purpose: Determine whether another TesSeRact-compliant program is already using the indicated hotkey. 

Available on: All machines. Restrictions: TesSeRact-compliant TSR must be 
present in system for return to be valid; 
else error code will be returned. 

Registers at call: Return Registers: 

AX = 5453h AX = FFFFh hot key conflicts with another TSR 

BX = 02h otherwise safe to use the hotkey 


CL = scan code of hot key 
Conflicts: None known. 


INTERRUPT 2Fh - Function 5453h, Subfunction 03h 
REPLACE CRITICAL ERROR HANDLER 


Purpose: Specify a new handler for the DOS critical error interrupt. 

Available on: All machines. Restrictions: TesSeRact-compliant TSR must be 
present in system for return to be valid; 
else error code will be returned. 


Registers at call: Return Registers: 
AX = 5453h AX = nonzero if unable to install new handler 
BX = 03h 


CX = TSR ID number 
DS:SI -> new routine for INT 24h 
Conflicts: None known. 


INTERRUPT 2Fh - Function 5453h, Subfunction 04h 


GET INTERNAL DATA AREA 

Purpose: Determine the address of the specified TSR's internal data. 

Available on: All machines, Restrictions: TesSeRact-compliant TSR must be 
present in system for return to be valid; 
else error code will be returned. 

Registers at call: Return Registers: 

AX = 5453h AX = 0000h 

BX = 04h ES:BX -> TSR's internal data area 

CX = TSR ID number (Table 36-25) 


nonzero, TSR not found 
Conflicts: None known. 


Table 36-25, Format of TesSeRact Internal Data Area: 


Offset Size Description 

00h BYTE revision level of TesSeRact library 
Olh BYTE type of popup in effect 

02h BYTE INT 08 occurred since last invocation 


03h BYTE INT 13 occurred since last invocation 
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Table 36-25. Format of TesSeRact Internal Data Area (continued) 





Offset Size Description 

04] BYTE active interrupts 

05h BYTE active soft interrupts 

06h BYTE DOS major version 

07h BYTE how long to wait before popping up 

08h DWORD pointer to INDOS flag 

OCH DWORD pointer to DOS critical error flag 

10h WORD PSP segment of interrupted program 

12h WORD PSP segment of prog interrupted by INT 28 
14h DWORD DTA of interrupted program 

18h DWORD DTA of program interrupted by INT 28 

1¢ WORD SS of interrupted program 

1Eh WORD SP of interrupted program 

20h WORD SS of program interrupted by INT 28 

22 WORD SP of program interrupted by INT 28 

24h DWORD __ INT 24 of interrupted program 

28) 3 WORDs DOS 3+ extended error info 

2Eh BYTE old BREAK setting 

2Fh BYTE old VERIFY setting 

30h BYTE were running MS WORD 4.0 before popup 
3th BYTE MS WORD 4.0 special popup flag 

32h BYTE enhanced keyboard call in use 

33h BYTE delay for MS WORD 4.0 

34h table Interrupt vector data, repeated 11 times (for INTs 08h, 09h, 13h, 16h, 1Ch, 21h, 28h, 2Fh, 





1Bh, 23h, and 24h): 
DWORD _ old interrupt vector 
BYTE interrupt number 
WORD offset in TesSeRact code segment of new interrupt handler 


INTERRUPT 2Fh - Function 5453h, Subfunction 05h 


SET MULTIPLE HOT KEYS 

Purpose: Request one or more secondary hotkeys. 

Available on: All machines, Restrictions; TesSeRact-compliant TSR must be 
present in system for return to be valid; 
else error code will be returned. 

Registers at call: Return Registers: 

AX = 5453h AX = nonzero, unable to install hot keys 

BX = 05h 


CX = TSR ID number 
DL = number of additional hot keys to allocate 
DS:SI -> table of hot keys 

BYTE hotkey scan code 

BYTE hotkey shift state 

BYTE flag value to pass to TSR (nonzero) 
Conflicts: None known. 


INTERRUPT 2Fh - Function 5453h, Subfunctions 06h-0Fh 


RESERVED 
Purpose: These functions are reserved for future enhancements to the standard. 
Available on: All machines. Restrictions: TesSeRact-compliant TSR must be 


present in system for return to be valid; 
else error code will be returned, 


Miscellaneous APIs 36-73 


Registers at call: Return Registers: unchanged. 
AX =5453h 

BX = 06h - OFh 

Conflicts: None known, 


INTERRUPT 2Fh - Function 5453h, Subfunction 10h 


ENABLE TSR 

Purpose: Turn on the specified TSR which was previously installed. 

Available on: All machines. Restrictions: TesSeRact-compliant TSR must be 
present in system for return to be valid; 
else error code will be returned. 

Registers at call: Return Registers: 

AX = 5453h AX = nonzero if unable to enable 

BX = 10h 


CX = TSR ID number 
Conflicts: None known. 


INTERRUPT 2Fh - Function 5453h, Subfunction 11h 


DISABLE TSR 

Purpose: Temporarily turn off the specified TSR. 

Available on: All machines, Restrictions: TesSeRact-compliant TSR must be 
present in system for return to be valid; 
else error code will be returned, 

Registers at call: Return Registers: 

AX = 5453h AX = nonzero if unable to disable 

BX = 1th 


CX = TSR ID number 
Conflicts: None known. 


INTERRUPT 2Fh - Function 5453h, Subfunction 12h 


UNLOAD TSR 

Purpose: Attempt to remove the specified TSR from memory. 

Available on: All machines. Restrictions; TesSeRact-compliant TSR must be 
present in system for return to be valid; 
else error code will be returned. 

Registers at call: Return Registers: 

AX = 5453h AX = nonzero if invalid TSR number 

BX = 12h 


CX = TSR ID number 

Details: If any interrupts used by the TSR have been grabbed by another TSR, the TesSeRact routines will wait until 
it is safe to remove the indicated TSR from memory. This may never happen, as the grabbed interrupts must be 
restored before a "safe" condition exists. 

Conflicts: None known. 


INTERRUPT 2Fh - Function 5453h, Subfunction 13h 


RESTART TSR 

Purpose: Attempt to restore a partially-unloaded TSR to operation. 

Available on: All machines. Restrictions: TesSeRact-compliant TSR must be 
present in system for return to be valid; 
else error code will be returned. 

Registers at call: Return Registers: 

AX = 5453h AX = nonzero, unable to restart TSR 


BX = 13h 
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CX = TSR ID number of TSR which was unloaded 
but is still in memory 
Conflicts: None known. 


INTERRUPT 2Fh - Function 5453h, Subfunction 14h 


GET STATUS WORD 

Purpose: Determine the current values of application-dependent bit flags. 

Available on: All machines. Restrictions: TesSeRact-compliant TSR must be 
present in system for return to be valid; 
else error code will be returned. 

Registers at call: Return Registers: 

AX = 5453h AX = FFFFh invalid 1D number 

BX = 14h other, successful 

CX = TSR ID number BX = bit flags 


Conflicts: None known. 


INTERRUPT 2Fh - Function 5453h, Subfunction 15h 


SET STATUS WORD 

Purpose: Specify a new state for application-dependent bit flags. 

Available on: All machines. Restrictions: TesSeRact-compliant TSR must be 
present in system for return to be valid; 
else error code will be returned. 

Registers at call: Return Registers: 

AX = 5453h AX = nonzero if unable to set status word 

BX = 15h 


CX =TSR ID number 
DX = new bit flags 
Conflicts: None known. 


INTERRUPT 2Fh - Function 5453h, Subfunction 16h 


GET INDOS STATE AT POPUP 

Purpose: Determine whether the TSR was popped up while a DOS call was in progress. 

Available on: All machines, Restrictions: TesSeRact-compliant TSR must be 
present in system for return to be valid; 
else error code will be returned. 

Registers at call: Return Registers: 

AX = 5453h AX = 0000h successful 

BX = 16h BX = value of INDOS flag 


CX = TSR ID number 
Conflicts: None known. 


INTERRUPT 2Fh - Function 5453h, Subfunctions 17h-1Fh 


RESERVED 

Purpose: These functions are reserved for future enhancements to the standard. 

Available on: All machines. Restrictions; TesSeRact-compliant TSR must be 
present in system for return to be valid; 
else error code will be returned. 

Registers at call: Return Registers: unchanged. 

AX = 5453h 

BX = 17h - LFh 


Conflicts: None known. 
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INTERRUPT 2Fh - Function 5453h, Subfunction 20h 


CALL USER PROCEDURE 

Purpose: Invoke the specified TSR's user function. 

Available on: All machines. Restrictions: TesSeRact-compliant TSR must be 
present in system for return to be valid; 
else error code will be returned. 

Registers at call: Return Registers: 

AX = 5453h AX = 0000h successful 

BX = 20h 


CX = TSR ID number 
ES:DI -> user-defined data 
Conflicts: None known. 


INTERRUPT 2Fh - Function 5453h, Subfunction 21h 


STUFF KEYBOARD BUFFER 

Purpose: Request that the specified keystrokes be placed in the keyboard buffer after the TSR pops down. 

Available on: All machines. Restrictions: TesSeRact-compliant TSR must be 
present in system for return to be valid; 
else error code will be returned. 

Registers at call: Return Registers: 

AX = 5453h AX = 0000h success 

BX =21h FOFOh user aborted with 4C or ‘Break 

CX = TSR ID number other unable to stuff keystrokes 

DL = speed 


00h stuff keystrokes only when buffer is empty 
Oth stuff up to four keystrokes per clock tick 
02h stuff up to 15 keystrokes per clock tick 
DH = scan code flag 
if zero, buffer contains alternating ASC7I and 
sean codes 
if nonzero, buffer contains only ASCII codes 
SI = number of keystrokes 
ES:DI -> buffer of keystrokes to stuff 
Conflicts: None known. 


INTERRUPT 2Fh - Function 5453h, Subfunction 22h 


TRIGGER POPUP 

Purpose: Request that the specified TSR pcp up if possible. 

Available on: All machines. Restrictions: TesSeRact v1.10-compliant TSR must 
be present in system for return to be 
valid; else error code will be returned. 

Registers at call: Return Registers: 

AX = 5453h AX = 0000h success 

BX = 22h (v1.10) TSR will either pop up or beep to indicate that 

CX = TSR ID number it is unable to pop up 


nonzero invalid ID number 
Conflicts: None known. 


INTERRUPT 2Fh - Function 5453h, Subfunction 23h 
INVOKE TSR'S BACKGROUND FUNCTION 


Purpose: Permit the specified TSR to perform actions in the background. 
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Available on: All machines. Restrictions: TesSeRact v1.10-compliant TSR must 
be present in system for return to be 
valid; else error code will be returned. 


Registers at call: Return Registers: 

AX = 5453h AX = 0000h success 

BX = 23h (v1.10) FFFFh not safe to call background function 
CX = TSR ID number else invalid ID number 


Conflicts: None known. 


INTERRUPT 2Fh - Function 5453h, Subfunctions 24h-2Fh 


RESERVED 

Purpose: These functions are reserved for future enhancements to the standard. 

Available on: All machines, Restrictions: TesSeRact-compliant TSR must be 
present in system for return to be valid; 
else error code will be returned. 

Registers at call: Return Registers: unchanged. 

AX = 5453h 

BX = 24h - 2Fh 

Conflicts: None known. 

TRAP.COM 


TRAP is an interrupt call tracer by Patrick Phillipot and Udo Chrosziel. 
INTERRUPT 2Fh - Function DAh, Subfunction 55h 


INSTALLATION CHECK 

Purpose: Determine whether TRAP.COM has been installed. 

Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 

AX =DASS5h if installed 

DL = interrupt number AH = interrupt number 
DH = unknown. AL = unknown. 


ES:BX -> unknown. 
Details: A separate copy of TRAP is loaded for each interrupt to be traced; thus the interrupt number is part of the 
installation check. 
Conflicts: None known, 


TurboPower TSRs 
TurboPower Software's Turbo Professional and Object Professional libraries for Turbo Pascal provide standardized 
methods for creating TSR programs. 


INTERRUPT 16h - Function E0h, Subfunction E0h 
ALTERNATE INSTALLATION CHECK 


Purpose: Check for the presence of TurboPower TSRs. 


Available on: All machines. Restrictions: none. 
Registers at call: Return Registers; 
AX = EOEOh AX = 1FI1Fh if installed 


DWORD 0040h:00F0h -> last data block in TSR 
list (see Function FOh Subfunction FOh) 
Details: The returned TSR list provides support for communication among TSRs built with TurboPower's Turbo 
Professional and Object Professional libraries for Turbo Pascal. 
Conflicts: None known. 
See Also: Function F0h Subfunction FOh 
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INTERRUPT 16h - Function F0h, Subfunction F0h 


INSTALLATION CHECK 

Purpose: Check for the presence of TurboPower TSRs. 

Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 

AX = FOFOh AX = OFOFh if installed 


ES:DI -> last data block (Table 36-26) in TSR list 
Details: The returned TSR list provides support for communication among TSRs built with TurboPower's Turbo 
Professional and Object Professional libraries for Turbo Pascal. 
Conflicts; Compaq 386 Set CPU Speed (chapter 4). 
See Also: Function E0h Subfunction E0h 


Table 36-26. Format of TurboPower TSR Data Block: 


Offset Size Description 
00h DWORD _ pointer to program tag (counted ASCII string) 
04h WORD interface version number (0400h) 
06h DWORD pointer to command entry point 
OAh DWORD pointer to previous data block (0000h:0000h if none) 
OEh DWORD _ pointer to next data block (0000h:0000h if none) 
---swappable TSRs only--- 
12h DWORD pointer to swapping data 
16h DWORD pointer to user data 
possibly additional fields 
VIDCLOCK.COM 


VIDCLOCK.COM is a memory-resident clock by Thomas G. Hanlin III. 
INTERRUPT 2Fh - Function AAh, Subfunction 00h 


INSTALLATION CHECK 

Purpose: Determine whether VIDCLOCK.COM has been installed. 

Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AX = AAOOh AL = 00h not installed 


FFh installed 
Conflicts: None known. 


WATCH.COM 
WATCH.COM is part of the "TSR" package by Kim Kokkonen (TurboPower Software), which also includes MARK 


and RELEASE. 
INTERRUPT 16h - Function 77h, Subfunction 61h 


INSTALLATION CHECK 

Purpose: Determine whether WATCH.COM has been installed. 

Available on: All machines. Restrictions: none. 

Registers at call: Return Registers: 

AX =7761h (wa) AX = 5741h (WA’) if installed 
Conflicts: PeAnywhere III (chapter 28), PC Magazine PUSHDIR.COM. 

WCED 


WCED is a free command-line editor and history utility by Stuart Russell. 
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INTERRUPT 21h - Function 0Ah, Subfunction 00h 


INSTALLATION CHECK 
Purpose: Determine whether WCED version 1.6 or higher has been installed. 
Available on: All machines. Restrictions: none. 
Registers at call: Return Registers: 
AX =0A00h buffer offset 02h-05h filled with "Weed" if installed 
DS:DX -> 6-byte buffer whose first two bytes must 
be 00h 


Conflicts: DOS 1+ Buffered Input (chapter 8). 
See Also: CED Function FFh 


WHOA!,COM 
WHOA!.COM is a system slow-down utility by Brad D. Crandall. 


INTERRUPT 2Fh - Function 89h, Subfunction 00h 


INSTALLATION CHECK 

Purpose: Determine whether WHOA!.COM is installed. 

Available on: All machines. Restrictions: none. 

Registers at call: Return Registers: 

AX = 8900h AL = 00h not installed 
FFh installed 

Conflicts: None known. 

See Also: Function 89h Subfunctions 01h and 02h 

INTERRUPT 2Fh - Function 89h, Subfunction 0th 

UNINSTALL 

Purpose: Attempt to remove WHOA! from memory. 

Available on: All machines. Restrictions: WHOA!.COM must be installed. 

Registers at call: Return Registers: 

AX = 8901h AL = FDh successful 
FEh error 

Conflicts: None known. 

See Also: Function 89h Subfunction 00h 

INTERRUPT 2Fh - Function 89h, Subfunction 02h 

SET DELAY COUNT 

Purpose: Specify how much to slow down the system. 

Available on: All machines, Restrictions: WHOA!.COM must be installed. 

Registers at call: Return Registers: 

AX = 8902h AL = FDh successful 

BX = delay count (larger values slow system down FEh error 

more) 


Conflicts; None known. 
See Also: Function 89h Subfunction 00h 


WILDUNIX.COM 
WILDUNIX.COM is a resident UNIX-style wildcard expander by Steve Hosgood and Terry Barnaby. 


INTERRUPT 2th - Function 4Eh 
INSTALLATION CHECK 


Purpose: Determine whether WILDUNIX.COM is installed. 
Available on: All machines. Restrictions: none. 
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Registers at call: Return Registers: 
AH = 4Eh AH = 99h if installed 


DS:DX = 0000h:0000h 
Conflicts: DOS 2+ Find First Matching File (chapter 8). 


WORD PERFECT 5.0 Third Party Interface 


INTERRUPT 1Ah - Function 36h, Subfunction 01h 
WORD PERFECT 5.0 Third Party interface - INSTALLATION CHECK 


Purpose: Called by Word Perfect 5.0 at startup to determine whether a third-party product wishes to monitor Word 
Perfect's keyboard input. 


Available on: All machines. Restrictions: none. 

Registers at call: Return Registers: 

AX = 3601h DS:SI = routine to monitor keyboard input, 
immediately preceded by the ASCIZ string 
"WPCORP\O" 


Details: Before checking for keyboard input, and after every key entered by the user, Word Perfect will call the 
routine whose address was provided in DS:SI, with the following parameters: 
Entry: AX = key code or 0 
BX = WordPerfect state flag 
Exit: AX = 0 or key code 
BX = 0 or segment address of buffer with key codes 
See the "WordPerfect 5.0 Developer's Toolkit" for further information. 
Conflicts: None known. 





| 
i 
| 
i 
i 
1 
i 
{ 
{ 


Bibliography 


Julie Anderson, "Irresistible DOS 3.0", PC Tech Journal, volume 3 number 12, December 1984, p. 74-87. 
Steven Armbrust and Ted Forgeron, ".OBJ Lessons", PC Tech Journal, volume 4 number 10, October 1985, p. 62-81. 


Penn Brumm and Don Brumm, 80386: A Programming and Design Handbook (2nd ed). TAB Books, 1989. ISBN 
0-8306-3237-9. 


Banyan Systems, Inc., VINES Programmer’ s Interface (DOS), Banyan Systems, Inc. 2 June 1988. 


Btrieve Reference Manual, Rev. 2.00, for Btrieve Version 5.0 and above. Novell Development Products Division, 
6034 W. Courtyard Suite 220, Austin TX 78370, October 1988. Novell P/N 100-410000-410. 


Byte Magazine, Volume | number 12 (1987 Extra Edition). 


Ken W. Christopher, Jr., Barry A. Feigenbaum, and Shon O, Saliga, Developing Applications Using DOS, John Wiley 
and Sons 1990, 573pp. ISBN 0-471-52231-7. 


Computer Language Magazine, March 1990 (special issue on Windows). 

Ralph Davis, "Developing for NetWare", PC Tech Journal, volume 6 number 8, August 1988, p. 108-129. 

DECnet DOS Programmer's Reference Manual, Digital Equipment Corp., AA-EB46C-TV. 

Digital Communications Associates, Inc. and Intel Corporation, DCA/Intel Communicating Applications Specifica- 
tion, version 1.2, 27 September 1990, Intel Corporation, part number 301812-004 (supercedes DCA/Intel Com- 
municating Applications Specification, Version 1.0A, September 1988), 


The DPMI Committee, DOS Protected Mode Interface (DPMI) Specification, Version 0.9. Intel Corporation, 15 May 
1990, order number 240763-001. 


The DPMI Committee, DOS Protected Mode Interface (DPMI) Specification, Version 1.0. Intel Corporation, 12 
March 1991, order number 240977-001. 


Ray Duncan, Advanced MS-DOS (Ist ed), Microsoft Press, 1986, 468pp. ISBN 0-914845-77-2. 


Ray Duncan, Advanced MS-DOS Programming: The Microsoft Guide for Assembly Language and C Programmers 
(2nd ed), Microsoft Press, 1988. 


Ray Duncan, "DOS Extenders Old and New: Protected-Mode Programming in DOS", PC, volume 10 number 4, 26 
February 1991, p. 385-391. 


Ray Duncan (editor), Extending DOS, Addison-Wesley 1990, 432pp. ISBN 0-201-55053-9. 
Ray Duncan, /BM ROM BIOS, Microsoft Press, 1988, 126pp. ISBN 1-55615-135-7, 
B-7 


j 
| 
i 
if 
\ 
| 
H 
i 
' 
i 
i 
| 
i 
i 
i 
i 
| 





Ray Duncan (editor), The MS-DOS Encyclopedia, Microsoft Press, 1988, 1570pp. ISBN 1-55615-174-8. 
Bo Ericsson, "VESA VGA BIOS Extensions", Dr. Dobb’s Journal #163, April 1990, p. 65H-70. 


Ted Forgeron, "We Interrupt This Program", PC Tech Journal, volume 4 number 4, April 1985, p. 42. 
Tech Notebook on trapping control-break. 


Susan Glinert-Cole, "A Network for All Reasons", PC Tech Journal, volume 3 number 12, December 1984, p. 90- 
106. 

Discussion of the IBM PC Network, and brief looks at INT 2Ah and INT 5Ch. 

Augie Hansen, "Detecting Display Systems", PC Tech Journal, volume 5 number 7, July 1987, p. 174-182. 


J. Axorr Haugdahl, "The DOS-LAN Juncture”, PC Tech Journal, volume 5 number 7, J uly 1987, p 78-90, 
Includes a detailed description of file-sharing modes. 


Thomas V. Hoffmann, “Graphic Enhancement", PC Tech Journal, volume 4 number 4, April 1985, p. 58-71. 


Michael Holmes and Bob Flanders, "PCSPOOL Lets You Get Back to Work While You Print", PC, volume 10 num- 
ber 1, 15 January 1991, p. 419-433, 


Intel Corporation, 80286 and 80287 Programmer’s Reference Manual. Intel Corporation 1987, order number 
210498-004. ISBN 1-55512-055-5. 


Intel Corporation, i486 Microprocessor Programmer’ s Reference Manual. McGraw-Hill 1990. ISBN 0-07-881674-2, 
Stephen E. Jones, General Software Project STARLITE: Architecture Specification, 1 October 1990. 


Art Krumrey, "NetWare in Control", PC Tech Journal, volume 4 number 11, November 1985, p. 102-119. 
Briefly covers NetWare interrupt calls. 


John A. Lefor and Karen Lund, "Reaching into Expanded Memory", PC Tech Journal, volume 5 number 5, May 
1987, p. L00-124. 


Pete Maclean, "1STCLASS and COURIERS Make Binary MCI Transfers Easy", PC, volume 8 number 19, 14 No- 
vember 1989, p. 399-408, 


Microsoft MS-DOS CD-ROM Extensions Function Requests, Microsoft Corporation, 28 May 1988. MSCDEX v2.00 
documentation, 


Microsoft MS-DOS CD-ROM Extensions Function Requests Specification, Microsoft Corporation, 29 March 1989, 
MSCDEX v2.10 documentation. 


Microsoft MS-DOS CD-ROM Extensions Hardware-Dependent Device Driver Specification, Microsoft Corporation, 
17 March 1989. Document number 00008001 0-100-000-1186. 


Stan Mitchell, "Building Device Drivers", PC Tech Journal, volume 4 number 5, May 1985, p. 76-87. 


Rick Moore, "Fundamentals of FOSSIL Implementation and Use, Version 5", Fidonet document FSC-0015, 11 Feb- 
ruary 1988. 


Rick Moore, "VFOSSIL - An OS/2-Subset Video FOSSIL Appendage, Version 1.00", Fidonet document FSC-0021, 
23 May 1988. 





Novell, Inc., NetWare System Calls, Rev. 1 00, Novell Development Products Division, #917, P.O.Box 9802, Austin 


TX 78766, April 1989. Novell P/N 100-000571-001. 
supercedes Advanced NetWare 2.0 Reference, Novell, and NetWare Function Call Reference. 


Novell, Inc., NetWare System Interface Technical Overview, Addison-Wesley 1990, 346+xvi pp. 
ISBN 0-201-57027-0. 


Vincent E. Perriello, "Fundamentals of FOSSIL Implementation and Use, Draft Version 4", Fidonet document FSC- 
0008, 10 August 1987. 


Phoenix Technologies, System BIOS for IBM PCIXTIAT Computers and Compatibles, Addison-Wesley, 1989, 524pp. 
ISBN 0-201-51806-6. 


Paul Pierce, "The Dashed Cursor", PC Tech Journal, volume 4 number 12, December 1985, p. 47. 
Discusses a bug in the EGA BIOS which turns underline cursor into dash. 


Jeff Prosise, "Mouse Software: See How They Run", PC, volume 6 number 13, July 1987, p. 411-428. 
Quarterdeck Office Systems, DESQview API Reference Guide, 232pp. 
Que Corporation, DOS and BIOS Functions Quick Reference. Que Corporation, 1989, 154pp. ISBN 0-88022-426-6. 


Guy Quedens and Gary Webb, "Switching Modes", PC Tech Journal, volume 4 number 8, August 1985, p. 163-173. 
Switching the 286 into and out of protected mode. 


Glen F. Roberts, "Finding Disk Parameters", PC Tech Journal, volume 4 number 5, May 1986, p. 112-150. 


Robin Rodabaugh, "Accelerating 2.1", PC Tech Journal, volume 5 number 4, April 1986, p. 43. 
Reducing floppy head-settling time for faster throughput. 


Leo J. Scanlon, "An Alarm for the AT", PC Tech Journal, volume 5 number 4, April 1986, p. 179-182. 
Introduces the real-time clock’ s alarm and INT 4Ah. 


Andrew Schulman, Raymond J. Michels, Jim Kyle, Tim Paterson, David Maxey, and Ralf Brown, Undocumented 
DOS: A Programmer's Guide to Reserved MS-DOS Functions and Data Structures. Addison-Wesley, 1990, 
694+xviii pp. ISBN 0-201-57064-5. 


W. David Schwaderer, "Exploiting NetBIOS", Programmer’ s Journal, volume 8.1, January/February 1990, p. 39-45. 
W. David Schwaderer, C Programmer’ s Guide to NetBIOS. Howard Sams 1988. ISBN 0-672-22638-3. 
Paul Somerson, "DOS Lives", PC, volume 6 number 13, July 1987, p. 175-188. Overview of DOS 3.3. 


Robert B. Stam, "Environmental Excavations", PC Tech Journal, volume 4 number 2, February 1985, p. 90-98. 
Getting at the DOS environment from Turbo Pascal. 


George Adam Stanislav, "AVATAR: Advanced Video Attribute Terminal Assembler and Recreator", Fidonet docu- 


ment FSC-0025, 23 August 1988. 
Describes AVATAR level 0 codes as used in the Opus BBS software. 
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George Adam Stanislav, "AVATAR: Advanced Video Attribute Terminal Assembler and Recreator", Fidonet docu- 
ment FSC-0037, 1 May 1989 (revised 25 November 1989), 
Describes the additional codes made available in AVATAR level 0+. 


Michael Triner, “The High Road to Host Connectivity", PC Tech Journal, volume 7 number 1, January 1989, 
p. 85-94. 


Video Electronics Standards Association, Super VGA BIOS Extension, Standard #VS900602, 2 June 1990. 
Virtual Control Program Interface, Version 1.0. Phar Lap Software, 12 June 1989. 


Richard Wilton, "DOS Marches On", PC Tech Journal, volume 7 number 1, January 1989, p. 99-108. 
Description of new DOS 4.0 features. 


Additional References 


Many of the reference materials from which information in the interrupt list were extracted have been lost in the mists 
of time, or were never indicated by contributors in the first place. The following is a list of the materials for which we 
have only partial references. 


10-Net Reference Manual v2.0. 

Advanced Program-to-Program Communication for the IBM Personal Computer, 
Programming Guide (2nd ed), December 1986. 

Carbon Copy Plus user’ s manyal. 

Compag DeskPro 386 Technical Reference Guide . 

Dr. Dobbs’ Journal, May 1986 (BIOS Window Ext.). 

ET4000 Graphics Controller Data Book, Tseng Labs. 

Everex Viewpoint Owner’ s Manual and Reference Guide, version 1.0, Everex Corp. 

Hercules GraphX manual, edition 2.1, August 1986, 

IBM 3270 Workstation Program Version 1.10, Programming Guide, December 1987. 

Inset Systems, /nset Extended Specification, 23 November 1988. 

Intel Image Processing Interface Specification, Version 1.0, 1989, 

LAN-Magazine, issue #1. 

LANtastic (tm) Network Operating System Technical Reference Manual . 

LANtastic (tm) Network Operating System Technical Reference Manual, version 3.0, 13 June 1990, 

MS-DOS Extensions Quick Reference, Ray Duncan Microsoft Systems Journal, September 1987, 

Microsoft Windows 3.0 Device Driver Kit. 

Novell Network Driver Interface Specification 2.01, 18 May 1990 

Networking Software, ed. Colin B, Ungaro, McGraw Hill, p265, 

PC Mouse Reference Manual v4.00. 

PCITCP Packet Driver Specification, version 1.09. 

FTP Software Professional Development Series Bulletins, v2n5, June 1990. 

Video Seven VGA Technical Reference Manual. 

pcANYWHERE v2.10 User’s Guide . 





10Net: 23-1 
$SCNTL record: 23-9 
chat: 23-6 
configuration table: 23-3, 
23-10 
FCB locking: 23-9, 23-10 
file locking: 23-5 
login: 23-1, 23-2 
login record; 23-1 
machine names: 23-7 
mounting drives: 23-11, 
23-12 
node status: 23-2 
printer: 23-9 
receive buffer: 23-5 
receiving data: 23-4 
remote memory: 23-10 
semaphores: 23-6, 27-32 
sending data: 23-4 
shared device table: 23-11 
shared devices: 23-10, 
23-11 
spool/print record: 23-7 
spooler: 23-7 
statistics; 23-4 
status codes: 23-1 
submit record: 23-5 
submitting commands: 23-5 
superstations: 23-2, 23-7 
usernames; 23-7 

$25 LAN 
connections: 27-21 
installation check: 27-21 

3270 emulation 
PCOX: 20-25 

3270 Workstation Program 
3270 emulation: 26-9 
copy service: 26-10 
data conversion: 26-10 
DOS access: 26-10 
gate names: 26-11 
host services: 26-11 


keyboard: 26-8 


operator information area: 


26-9 
presentation spaces: 26-9 
queues: 26-7, 26-11 
service codes; 26-8 
sessions: 26-7 
status: 26-12 
windows: 26-8 
3270PC 
installation check: 5-35 
3com: 23-1 
3com BAPI: 7-4 
break: 7-5 
command mode: 7-5 
initialization: 7-4 
input: 7-4 
installation check: 7-5 
output: 7-4 
status: 7-5 
3com Corporation: 27-6 
network address: 27-31 
semaphores: 27-32 
4DOS: 36-1 
executing programs: 36-2 
installation check: 36-1 
prompts: 36-3 
shell numbers: 36-2, 36-3 
SHELL2E uninstall: 36-1 
termination: 36-1 
8514/A: 5-74 
\DEV\ prefix: 8-22 


A20; 8-43, 10-2, 10-3, 11-13 
ABIOS 
initialization: 3-3, 3-4 
initialization table: 3-4 
system parameter table: 3-3 
Active page: 5-13, 5-18, 5-37 
Ad Lib—see SOUND.COM: 
36-3 


Index 


Adaptec 
drive data: 6-22, 6-23 
Address field buffer: 6-5 
Address line A20—-see A20 
Al Architects: 9-14 
Alarm: 3-24, 3-25, 3-27 
real-time clock: 4-1 
status: 3-25 
Alias segments: 9-16 
Alignment check: 2-8 
Alloy Computer Products, Inc.: 
18-1 
Alloy: 18-1 
386/MultiWare—see 
MW386: 18-1 
Netware Support Kit-—see 
ANSK: 18-1 
Novell-Type Network Ex- 
ecutive—see NTNX: 18-1 
record locking: 20-9, 20-10 
semaphores: 27-35 
AMI 386 BIOS: 5-12 
AMI BIOS: 6-2, 6-3, 6-7, 6-8 
Amstrad PC1512: 4-1 
mouse: 4-1 
non-volatile RAM: 4-1, 4-2: 
version check: 4-3 
video: 4-2, 4-3 
ANARKEY: 36-5 
ANARKMD API: 36-6 
enabling: 36-7 
installation check: 36-5 
unknown functions: 36-6, 
36-7, 36-8 
ANSI control sequences: 5-66 
output: 7-14 
ANSLSYS: 8-98, 8-99 
/L flag: 8-99 
installation check: 8-98 
interlock state: 8-99 
screen information; 8-98 


MY 


ANSK 

installation checks: 18-14 

terminal output: 18-31 

user number: 18-15 

version check: 18-29 
Anti-virals: 34-11 

TBSCANX: 34-13 

ThunderByte: 34-14 
APL*Plus/PC 

beep: 31-5 

graphics: 31-5 

memory availability: 31-4 

names: 31-3, 31-4 

object creation: 31-1, 31-2 

outswapping: 31-3 

print screen: 31-4 

printer driver: 31-5 

R= space: 31-5 

reserved interrupts: 31-6 

shape model: 31-1 

termination: 31-1 

timing: 31-6, 31-7 

unknown functions: 31-1, 

31-6 

video: 31-5, 31-6 

virtual memory: 31-3 
APPC/PC: 25-1, 25-7 

API tracing: 25-11 

connection control: 25-4 

data conversion: 25-10 

device control: 25-1 

enable/disable: 25-10 

error codes: 25-7 

logical devices: 25-2 

message tracing: 25-11 

messages: 25-9 

network devices: 25-1 

passthrough: 25-10, 25-12 

password: 25-4 

physical devices: 25-1, 25-2 

receive data: 25-6 

yeturn codes: 25-3, 25-7, 

25-10 

send data: 25-6 

sessions; 25-9 

SYSLOG: 25-4 

tracing: 25-11 

transaction processing: 25-8 
APPEND: 8-99, 27-14 

/E flag: 8-100 

/PATH flag: 8-100 

/X flag: 8-100 

APPEND path: 8-100 


found name state: 8-101 
installation check: 8-99 
INT 21h hook: 8-100 
state: 8-100 
version check: 8-100, 8-101 
APPEND path: 8-100 
AppleTalk: 27-21 
BDS: 27-24 
control block: 27-22 
installation check: 27-22 
Name Binding Protocol: 
27-24 
Arbiter: 26-6 
Artisoft, Inc.: 21-1 
ASCIZ strings: 8-108, 8-113 
ASSIGN: 8-83, 8-101, 27-15 
drive assignment table: 
8-101 
installation check: 8-101 
AST Premier 386 BIOS: 5-12 
AT&T 6300: 4-3 
time: 4-3 
AT&T Starlan 
NetBIOS: 27-20 
installation check: 27-12 
Network Control Block: 
27-20 
Extended NetBIOS: 27-12 
AT&T VDC600 
emulation control: 5-11 
mode setting: 5-11 
Atari Portfolio: 4-4 
BIOS: 4-4 
user interface: 4-4 
ATI 
BIOS entry point: 5-72 
enhanced features: 5-29 
Super Switch: 5-45 
VCONFIG: 5-45 
Attachmate Corporation: 26-3 
Attachmate Extra 
3270 display state: 26-2, 
26-3 
cursor position: 26-4 
host functions: 26-4 
host window buffer: 26-4 
keystrokes: 26-3 
screen updates: 26-5 
translation table: 26-4 
AutoCAD: 36-8 
device interface: 36-8 
AUTOPARK: 6-11 


Extended 


installation check: 6-11 
Availdev: 8-22 
AVATAR protocol: 36-8 
AVATAR Serial Dispatcher: 7-6 
install handler: 7-6 
uninstall handler: 7-6, 7-7 
AVATAR.SYS: 36-8, 36-69 
data segment: 36-10 
driver state: 36-8, 36-9 
installation check: 36-8 
keyboard: 36-11 
unknown functions: 36-9, 
36-10, 36-11 
AWARD BIOS: 3-12, 6-2, 6-3, 
6-7, 6-8 


Back door 
COMMAND.COM: 8-97 
Back&Forth: 17-1 
installation check: 17-1, 
17-2 
switching tasks: 17-2 
BACKTALK 
installation check: 33-1 
uninstall: 33-1 
Bad sectors: 6-2 
Ballard, Alan: 5-72 
BANV-—see VINES: 22-1 
Banyan Systems, Inc.: 22-1 
Banyan VINES—see also 
VINES: 22-1 
record locking: 20-9, 20-10 
Barnaby, Terry: 36-77 
BASIC: 35-5 
invoking Cassette BASIC: 
3-21 
stored vectors: 35-5 
BCD: 3-23, 3-24, 3-25, 4-2 
Bennett, David H.: 36-17 
BlOS—see BIOSes, ROM 
BIOS: 3-1 
BIOS Parameter Block: 8-35, 
8-63 
BIOS Window Extension: 5-18, 
5-24, 5-26 
BlOSes 
AMI: 5-12, 6-2, 6-3, 6-7, 
6-8 
AST: 5-12 
AWARD: 6-2, 6-3, 6-7, 6-8 
Corona/Cordata: 5-14 


Phoenix: 5-1 
Blink bit: 5-15, 5-20 
Block devices: 8-119 
BMB Compuscience Canada: 
36-11 
installation check: 36-11 
BNU—sce also FOSSIL 
installation check: 7-10 
Boot drive: 8-20 
Booting: 3-21 
Bootstrap loader: 3-21 
Border color; 5-19, 5-20, 5-56 
Borland DOS extender: 9-21 
Borland International: 35-1 
floating point emulation: 
35-1, 35-2, 35-3 
DPMI loader: 11-1 
TKERNEL—see 
TKERNEL: 9-21 
BREAK flag: 8-19, 8-20 
Breakpoints: 2-2 
Btrieve: 36-12 
API: 36-12 
BREQUEST: 36-12 
function codes: 36-12 
status codes: 36-13 
Budget Software Company: 
36-15 


Cache controller 
disabling: 4-8 
enabling: 4-8 
status: 4-8 
Calendar: 3-24, 3-25, 3-26 
Calwas, Steven: 36-5 
CAM Control Block: 6-18 
Cameras: 14-10 
Canonical filenames: 8-27, 8-64, 
8-70, 8-71, 8-73, 8-82, 
8-83, 8-112, 19-13 
Capitalization: 8-87, 8-88, 8-108 
CapsLock: 3-18, 3-20 
Carbon Copy: 28-1 
connections: 28-1 
phone numbers: 28-1 
CAS: 29-1 
aborting events: 29-3 
autoreceive: 29-6 
CCITT identification: 29-6, 
29-8 
connect time: 29-7 


cover page: 29-8, 29-14 
deleting files: 29-4, 29-5 
diagnostics: 29-12 
error codes: 29-1, 29-12 
event status: 29-7 
events: 29-3, 29-5, 29-7, 
29-9 
external data block: 29-6 
file transfer record: 29-8 
hardware status: 29-9 
installation check: 29-1 
Intel Connection 
CoProcessor: 29-9, 29-10, 
29-11 
logo file: 29-6, 29-8 
moving files: 29-12 
opening files: 29-4 
page length: 29-8 
phonebook: 29-6 
queue status: 29-8 
queues: 29-3, 29-5, 29-8 
sending files: 29-13 
status: 29-7, 29-8, 29-9 
submitting tasks: 29-1 
tasks: 29-5, 29-6 
transfer type: 29-7 
uninstall: 29-13 
version check: 29-6 
Cassette BASIC: 3-21 
data transfer; 3-3 
motor control: 3-2 
CD-ROM: 8-55 
CDROM extensions—see also 
MSCDEX; 19-1 
abstract file: 19-17 
bibliography file: 19-17 
copyright file: 19-16 
debugging: 19-17, 19-18 
device driver requests: 
19-21 
directory entry: 19-20 
disk reads: 19-18 
disk writes: 19-18 
drive check: 19-18 
drive device list: 19-16 
installation checks: 19-16 
Kanji: 19-19 
reserved functions: 19-18 
valid drives: 19-18, 19-19 
volume descriptor: 19-17, 
19-19 
volume table of contents: 
19-17 
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CED: 36-14 
installable commands: 
36-14 
installation check: 36-14 
Central Point Software: 33-1, 
36-61 
Century flag: 3-24 
Change line: 6-4, 6-5 
Character attribute: 5-15 
Character devices: 8-7, 8-44, 
8-112 
Character input: 8-2, 8-3, 8-4 
Character output: 8-2, 8-3, 8-4 
Chrosziel, Udo: 36-75 
lipboard: 14-7, 14-8, 14-9 
lock ticks: 3-26 
LOCKS: 8-29, 8-46, 8-55 
osing files: 8-7, 8-26, 8-43, 
8-49, 8-50, 8-70, 8-71, 
8-104, 8-106, 8-113 
Cluster Adapter: 27-21 
BIOS entry point: 27-20 
Cluster numbers: 8-6, 8-7, 8-12, 
8-19, 8-44, 8-50, 8-52, 8-53 
ClusterShare: 27-36 
CMC International: 6-23, 6-24, 
6-25 
CMDSPY—see also INTRSPY: 
36-27 
CMOS clock: 3-23, 3-24 
CMOS RAM: 4-1, 4-2, 4-9, 
4-10, 4-11 
EISA: 4-10 
CMOS: 2-16, 8-16, 8-17 
Code pages: 8-33, 8-34, 8-35, 8- 
86, 8-88, 8-89, 8-128, 8-129 
Collating sequence: 8-86 
COMI: 2-6 
COM2: 2-6 
Command codes 
device driver requests: 
8-121 
DR MultiUser DOS; 8-141 
NetBIOS: 27-25 
PC-IPC: 36-50 
Command EDitor—see CED 
Command line: 8-15 
COMMAND,COM: 8-102, 36-1 
and SHELLB: 8-135 
execute command: 8-97 


c 
Cc 
C 
Cl 
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installable commands: 
8-126 
Commercial Software Associ- 
ates: 17-1 
Common Access Method: 6-17, 
6-18 
installation check: 6-18, 
6-22 
Communicating Applications 
Specification—see CAS: 
29-1 
COMMUTE: 28-1 
installation check: 28-3 
unknown functions: 28-2, 
28-3 
Compaq: 4-4 
gray-scaling: 5-54 
video: 5-52, 5-53, 5-54 
Compaq 286/386: 3-13 
Compaq 386 
CPU speed: 4-7 
keyboard type: 4-7 
Compaq 80286s 
CPU speed: 4-8 
Compaq Deskpro: 3-13 
Compaq PC; 3-13 
Compag Plus: 3-13 
Compaq Portable 386 
LCD: 5-30, 5-31 
timeouts: 4-4 
Compaq SLT/286 
power conservation: 2-17, 
4-5, 4-6 
standby mode: 4-5 
timeouts: 4-4 
Compaq Systempro 
cache controller: 4-8 
processor availability: 4-7 
processor dispatch: 4-6 
Compaq Systempro: 3-2 
Compaq XT: 3-13 
Comparing pointers: 8-109 
Compatibility mode: 8-6 
CON: 8-27, 8-33, 8-46 
Concurrent DOS: 8-140 
Configuration: 3-11 
Control-Break checking: 8-19, 
8-20 
Control-Break interrupt: 8-92 
Control-Break: 3-26, 17-11 


Control-C: 8-2, 8-3, 8-4, 8-19, 
8-20, 8-43, 8-92, 
17-11 
Control-NumLock: 17-11 
Control-PrtSe: 17-11 
Convergent Technologies: 27-36 
Convertible: 3-13 
automatic power-up: 3-25 
external event wait: 3-5 
modem power: 3-6 
power off: 3-6 
system profiles: 3-5 
system resume vector: 3-27 
system status: 3-6 
Coprocessor: 2-3, 2-8, 3-1, 
11-30, 11-31 
Weitek: 3-2 
Coprocessor error: 2-17 
Corona/Cordata 
BIOS: 5-14 
graphics bitmap: 5-14 
Country code: 8-22, 8-23, 8-86 
Country-specific information: 
8-22, 8-23, 8-85, 8-129, 
8-130 
COURIERS.COM: 7-7 
break: 7-9 
cleanup: 7-9 
flush: 7-8 
input: 7-8 
installation check: 7-7 
output: 7-8, 7-9 
set parameters: 7-7, 7-9 
status: 7-7, 7-8 
Cox, Mark J,; 36-53 
CP/M BDOS call: 8-98 
CP/M compatibility: 8-10, 8-11, 
8-12, 8-14, 8-98 
CP/M-86: 36-15 
API: 36-15 
CPU registers 
CRO: 10-19 
debug registers: 10-19, 
11-27, 11-28 
CPU speed: 4-7, 4-8, 4-11 
CRO: 10-19 
Crandall, Brad D.: 36-77 
CRC checks: 8-17 
Creating files: 8-9, 8-24, 8-68, 
8-69, 8-91, 9-19 
unique files: 8-68, 8-69 


Creating PSP; 8-14, 8-64 
Critical error: 8-43, 8-105, 8-106 
message expansion: 8-102 
Critical error flag: 8-20, 8-45 
Critical error handler: 8-93, 
8-102 
installation checks: 8-102 
message expansion: 8-102 
Critical errors: 20-12 
and TesSeRact: 36-70 
Critical sections: 27-15, 27-16 
DESOQview: 15-51 
Microsoft Windows: 14-4 
MultiDOS: 16-8 
TopView: 15-4, 15-5 
Cross, Roger: 6-36 
Cswitch 
interprocess 
tion: 17-15 
priorities: 17-15 
queues: 17-15 
semaphores; 17-13, 17-14 
starting programs: 17-16 
starting tasks: 17-17 
swapping out tasks: 17-16 
task control block: 17-16, 
17-17 
task suspension: 17-14, 
17-15 
terminating programs: 
17-16 
threads: 17-14 
time slices: 17-13 ! 
CTask 
global data: 17-10 
installation check: 17-10 
CTOS: 27-36 
Current directory: 8-8, 8-19, 
8-24, 8-38, 8-54, 8-68 
Current directory structure: 
8-46, 8-48, 8-73, 8-74, 
8-77, 8-90, 8-109, 8-110, 
8-111, 19-2, 19-3, 19-9, 
19-15 
Current drive: 8-109 
Cursor position: 5-33 
in Attachmate Extra: 26-4 
Cursor scaling: 5-12 





communica- 


DAC—see Digital/Analog Con- 
verter: 5-21 


Data structures 


ONet $SCNTL record: 
23-9 

10Net chat control parame- 
ters: 23-6 

ONet chat message: 23-6 
10Net configuration table: 
23-3 

ONet login record: 23-1 
ONet node status: 23-2 
ONet receive buffer: 23-5 
10Net send data description 
record: 23-4 

10Net shared device table: 
23-11 

ONet spool/print record: 
23-7 

10Net station record: 23-7 
10Net submit record: 23-5 
3270PC configuration: 5-35 
3270PC control program 
level table: 5-36 

ABIOS initialization table: 
3-4 

ABIOS system parameter 
table: 3-3 

Ad Lib signature block: 
36-4 

Alloy busy structure: 18-26 
Alloy control packet: 18-28 
Alloy data transfer struc- 
ture; 18-28 

Alloy datagram request 
block: 18-23 

Alloy drive information: 
18-17 

Alloy full-channel _ struc- 
ture: 18-27 

Alloy port configuration 
table: 18-3 

Alloy reset packet: 18-39 
Alloy shared drive list: 
18-18 

Alloy status structure: 
18-26, 18-28 

Alloy system flags: 18-19 
Alloy user information re- 
cord: 18-16 

ANARKEY data: 36-6 
ANSLSYS parameter 
block: 8-99 

API info structure: 8-138 
APL shape model: 31-1 





APPC/PC control block: 
25-1, 25-5, 25-8, 25-9, 25- 
11 

APPC/PC CREATE_TP: 
25-4 

APPC/PC logical unit ac- 
cess password: 25-3 
APPC/PC SYSLOG: 25-4 
APPC/PC trace statistics: 
25-12 

AppleTalk control block: 
27-22 

AppleTalk Name Binding 
Protocol: 27-24 

ATI VCONFIG data area: 
5-45 

ATI VGA Wonder video 
mode table: 5-30 
Attachmate Extra transla- 
tion tables: 26-5 

BIOS Parameter Block: 
8-63, 8-122, 8-123 

bitmap structure: 30-2 
bitmap, WinOldAp: 14-8 
Btrieve parameter record: 
36-12 

callback info structure: 
8-136 

CAS external data block: 
29-6 

CAS file submission data: 
29-13 

CAS file transfer record: 
29-8 

CAS status area: 29-7 

CAS status buffer: 29-9 
CDROM directory entry: 
19-20 

CDROM drive device list: 
19-16 

CLOCK$ transfer record: 
8-55 

code page structure: 8-129 
collating table: 8-86 
COMMAND.COM — com- 
mandline: 8-98 

Common Access Method: 
6-18 

country-specific  informa- 
tion: 8-22, 8-23, 8-86 
current directory structure: 
8-53 

date/time record: 20-18 


5 


DDS, Virtual DMA Specifi- 
cation: 12-2 

DECnet DOS session con- 
trol block: 24-2 

DECnet DOS signature: 
24-7 

DESKTOP editor buffer: 
33-26 

DESKTOP hotkey table: 
33-28 

DESKTOP menus: 33-24 
DESKTOP video attributes: 
33-26 

DESKTOP window param- 
eters: 33-8 

DESKTOP, PC Tools: 
33-11 

DESQview .DVP file: 15-8 
DESQVIEW.DVO program 
entry: 15-44 

device driver header: 8-54 
disk buffer hash chain: 8-56 
disk buffer info: 8-56 

disk buffer: 8-55, 8-57 

disk buffers: 8-57 

disk read packet: 8-95 

disk serial number: 8-90 
disk write packet: 8-96 
diskette formatting: 6-5 
diskette parameter table: 
6-6 

DMA descriptor: 12-2 

DOS command line: 8-126 
DOS data segment subseg- 
ment control block; 8-48 
DOS device driver request 
header: 8-119 

DOS error message table: 
8-116 

DOS execution state: 8-43 
DOS line input buffer: 8-4 
DOS parameter list: 8-70 
double-byte character set: 
8-84 

DPMI descriptor buffer: 
11-7, 11-8 

DPMI host version buffer: 
11-17 

DPMI memory information: 
11-18, 11-22 

DPMI processor exception 
stack frame: 11-10, 11-11 
DPMI real mode call struc- 
ture: 11-13 
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Data Structures (continued) 


DPMI resident service pro- 
vider structure: 11-28 
DPMI shared memory allo- 
cation: 11-29 

drive data table: 8-121, 
8-122, 8-123 

drive parameter block: 

8-12, 8-19 

EDDS page tables: 12-2 
EDDS, Virtual DMA Spec- 
ification: 12-2 

EGA Register Interface Li- 
brary: 5-62 

ELRES history structure: 
36-17 

EMS copy data: 10-13 
EMS hardware configura- 
tion: 10-15 

EMS mappable physical ad- 
dress array: 10-14 
environment: 8-15 

Everex video mode infor- 
mation: 5-50 

EXE file header: 8-40 
EXEC parameter block: 
8-40 

EXEC record: 36-2 
Extended DMA Descriptor: 
12-2 

extended File Control 
Block: 8-6 

FAKEY tone array: 36-22 
File Control Block reserved 
fields: 8-6 

File Control Block: 8-6 

file sharing record: 8-51 
filename terminator table: 
8-87 

filename uppercase table: 
8-87 

FindFirst data block: 8-44 
fixed disk format buffer: 
6-7 

FOSSIL driver info: 7-16 
Frieze parameter table: 5-40 
generic IOCTL request: 
8-33, 8-34, 8-35, 8-36, 8-37 
global descriptor table: 3-9 
hard disk master boot sec- 
tor: 3-22 

hard disk parameter table: 
6-8, 6-12 


hard disk partition record: 
3-22 

HLLAPI parameter control 
block: 26-14 

IBM 802.2 CCB: 27-24 
IBM Convertible display 
parameters; 5-32 

IBM System 36/38 emula- 
tor data area: 26-1 
IBMCACHE error list: 6-28 
IBMCACHE status record: 
6-27 

FS driver list: 8-57 

FS open file structure: 

8-62 

IFS request block: 8-59 
Image Processing Interface: 
30-2, 30-3, 30-4 

instance data: 8-140 

ntel Connection 
CoProcessor status: 29-9 
Intel SatisFAXtion: 29-11 
KEYB internal data: 8-127 
LANtastic active user entry: 
21-9 

LANtastic message buffer: 
21-4 

LANtastic printer status: 
21-7 

LANtastic queue entry: 
21-6 

LANtastic stream informa- 
tion: 21-8 

LANtastic time block: 
21-11 

LANtastic user account 
structure: 21-3 

lead byte table: 8-84, 8-87 
list of lists: 8-46 

MDEBUG data: 36-40 
MDEBUG identification 
table: 36-38, 36-43 

memory control block: 
8-47, 8-48 

message storage area: 22-21 
metafile picture, 
WinOldAp: 14-8 

mouse parameter table: 
13-15 

MultiDOS system block: 
16-11 

MultiDOS task control 
block: 16-9 





NDIS common characteris- 
tics table: 27-9 

NDIS service-specific char- 
acteristics: 27-10 

NDIS service-specific sta- 
tus: 27-10 

NetBIOS name structure: 
27-26 

NetBIOS status: 27-26 
NetBIOS: 27-27 

NetWare capture flags: 

20-3 

NetWare connection ID 
table: 20-22 

NetWare date/time buffer: 
20-18 

NetWare event control 
block: 20-27 

NetWare file copy request 
structure: 20-23 

NetWare IPX header: 20-27 
NetWare object property: 
20-16 

NetWare SPX status buffer: 
20-32 

NetWare volume statistics: 
20-11 

Network Control Block: 
27-20, 27-25 

Network Driver Interface 
Specification: 27-7, 27-8 
network event text header: 
27-19 

non-volatile RAM: 4-1 
packet driver parameter 
table: 27-31 

packet driver statistics: 
27-34 

palette structure: 30-4 
PC-Cache internal: 6-34 
PC-IPC parameter block: 
36-50 

PC3270 signature: 26-12 
PCjr scancode translation 
table: 3-27 

PCRUN parameters: 33-19 
Phar Lap program load pa- 
rameter block: 9-7 

Phar Lap program parame- 
ter block: 9-14 

Phar Lap real-mode call pa- 
rameter block: 9-5, 9-6 
Phar Lap virtual memory 
Statistics: 9-10 


Data Structures (continued) 
PRINT submit packet: 
8-132 
program segment prefix: 
8-14 
PSP: 8-14 
ROM configuration table: 
3-12 
SCSI disk information: 

6-15 

SHARE lock record: 8-51 
special program names: 
8-63 

SPX header: 20-31 
STACKS code segment: 
8-48 

STACKS data segment: 
8-48 

startup info structure; 8-140 
swappable data area list: 
8-76 

swappable data area: 8-72, 
8-76 

SWELL info buffer: 36-63 
system FCB tables: 8-51, 
8-52, 8-53 

system file tables: 8-51, 
8-52, 8-53 

TAME data area: 36-65, 
36-66, 36-67 

task switchers: 8-136, 
8-138, 8-140 

TES status array: 7-21 
TesSeRact internal data: 
36-70 

TesSeRact user parameter 
block: 36-69 

time block: 21-11 
TKERNEL response buffer: 
9-21, 9-22 

TopView .PIF file: 15-8 
TopView panel file: 15-13 
TopView pointer message: 
15-15 

translation tables: 26-5 
TurboPower TSR data 
block: 36-76 

UliraVision font names 
table: 5-57 

UltraVision palette register 
list: 5-57 

uppercase table: 8-86 


VCPI protected = mode 
switch: 10-20 

version structure: 8-138 
VESA SuperVGA informa- 
tion: 5-41 

VESA video mode informa- 
tion: 5-41 

VGA state information: 
5-33 

VGA static functionality 
table: 5-34 

Video FOSSIL application 
function table: 5-65 

Video FOSSIL cursor type: 
5-67 

Video FOSSIL information: 
5-64 

Video FOSSIL video con- 
figuration: 5-66 

Video FOSSIL video mode 
data: 5-65 

video palette register list: 
5-20, 5-21 

video parameter table: 5-71 
VINES buffer descriptor: 
22-4, 22-5 

VINES category criteria 
block: 22-20 

VINES enumerate block: 
22-20 

VINES information block: 
22-11 

VINES IPC ports: 22-2 
VINES NiceName block: 
22-19 

VINES port record block: 
22-18 

VINES profile block: 22-12 
VINES status line: 22-11 
VINES terminal status area: 


22-16 
VINES unreliable data- 
gram: 22-4 


VUIMAGE: 5-18 
Windows instance items: 
14-3 
Windows startup informa- 
tion: 14-2 
WinOldAp clipboard: 14-8 
XDI XMS driver: 15-56 
XMS; 10-3 

‘ DATAMON: 33-4, 33-29 
API: 33-29 


1-7 


installation check: 33-4, 
33-29 
Date: 8-16 
Day counter: 3-25, 3-26 
DBLIBRARY: 36-61 
DBOS: 9-22, 9-23 
uninstall: 9-23 
DCOMPRES 
enable/disable: 6-39 
installation check: 6-39 
Debug registers, 80386: 10-19, 
11-27, 11-28 
Debugging 
DOS extenders: 9-6 
NewSpace: 6-39 
DECnet DOS 
break; 24-5 
Data Link Layer program: 
24-6 
installation check: 24-1 
LAT counters: 24-5, 24-6 
LAT services: 24-6 
Local Area Transport pro- 
gram: 24-4, 24-5, 
24-6 
network process: 24-6 
passwords; 24-5 
receive data: 24-1, 24-4 
session control blocks: 
24-2, 24-3 
sessions: 24-2, 24-3, 24-5 
signature: 24-7 
sockets: 24-3 
status: 24-1, 24-2, 24-4 
transmit data; 24-1, 24-4 
uninstall, CTERM: 24-4 
Default drive: 8-5, 8-10, 8-11, 
8-24 
Defect maps: 6-13, 6-14 
Delays: 3-8, 3-9, 8-112 
Deleting directories: 8-8 
Deleting files: 8-8, 8-27, 29-4, 
29-5 
Demand paging: 11-24 
DeskConnect: 28-3 
API: 28-3 
uninstall: 28-4 
DESKTOP 
clipboard: 33-13, 33-28 
color scheme: 33-3 
database: 33-10 
delays: 33-14 
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editor settings: 33-5 

editor; 33-26 

file manipulation: 33-15, 
33-16, 33-22 

file selection: 33-21 

flags: 33-9 

help: 33-25 

hotkeys: 33-27 

installation check: 33-12, 
33-24 

interrupt vectors: 33-25, 
33-27 

keyboard input: 33-21, 
33-23 

menu processing: 33-26, 
33-27 

menus: 33-20, 33-21, 
33-23, 33-26, 33-27 

mouse; 33-28 

popup menus: 33-20 

print options: 33-14 
printing: 33-14, 33-21 
pulldown menus: 33-23, 
33-24, 33-27 

removing windows: 33-12 
resident mode: 33-12 
restoring screen: 33-9 
sound: 33-20 

startup path: 33-5 

uninstall: 33-17, 33-25 
version string: 33-5 

video attributes: 33-25 
video buffer: 33-28 

video output: 33-13, 33-22, 
33-26 

window parameters: 33-7, 
33-8, 33-12, 33-13, 33-27 
window specifier; 33-8, 
33-13 

windows: 33-26, 33-27 


DESQview—see also TopView: 


15-1, 15-43, 27-14 

-DVP; 15-58, 15-59 

and DOS calls: 15-52 

and mouse: 15-47 

API level: 15-46 

common memory: 15-32, 
15-42, 15-44, 15-49, 15-50, 
15-51 

connecting windows: 

15-13, 15-26 

control character interpreta- 
tion: 15-20, 15-24, 15-48 


critical sections: 15-48, 15- 
51 

debugging output: 15-46 
DVXMS.DVR: 15-55 

error handling: 15-49 
extensions to TopView 
API: 15-26, 15-47 

External Device Interface— 
see External Device Inter- 
face: 15-54 

field mode: 15-26 
initialization: 15-55 
installation check: 15-53 
keyboard focus: 15-57 
keyboard input: 15-47, 

5-51 

eyboard mouse: 15-9 
Learn menu: 3-19 

mailbox name: 15-47 
mailboxes: 15-47 

mapping context: 15-10, 
5-50 

memory allocation: 15-46, 
5-47, 15-50, 15-51 
memory use: 15-44, 15-45, 
5-53 

object attributes: 15-32, 
5-34, 15-42, 15-43 

object types: 15-48 
OBJECTQ: 15-29 

Open Window menu: 15-8, 
15-44 

priorities: 15-29 

process creation: 15-8, 
15-56 

process swapping: 15-58 
program name: 15-43 
program number: 15-45 
relocated IRQs: 2-11, 2-12, 
2-13, 2-14, 2-15, 2-16 
screen virtualization: 15-9, 
15-52 

scripts: 15-9, 15-47, 15-51 
shadow buffer: 15-1, 15-53 
shadowing screen: 15-1, 
15-53 

special keystrokes: 3-19 
starting programs: 15-8 
Switch Windows menu: 
15-45 

system memory: 15-2, 15-8, 
15-9, 15-11, 15-32, 15-46, 
15-47, 15-53 

task control: 15-8, 15-52 








termination: 15-55 
undocumented functions: 
5-51, 5-52 

unknown functions: 15-44, 
15-45, 15-50, 15-53 
version check: 15-53 

video: 5-51, 5-52 

video address: 15-1 

video output: 15-46 

video parameters: 15-52 
window justification: 15-48 
windows: 15-13 

XDI—see External Device 
Interface: 15-54 

XDV; 15-43 


DESQview calls—see also 


Top View calls: 15-2 
APILEVEL: 15-46 
APPNUM: 15-45 
ASSERTMAP: 15-10, 
15-50 

ASSERTVIR: 15-52 
CSTYLE:; 15-48 
DBGPOKE: 15-46 
DISPATCHINT: 15-52 
DOSUSER: 15-52 
ENTERC: 15-51 
FINDMAIL: 15-47 
GETCOMMON: 15-50 
GETERROR: 15-49 
GETMEM: 15-46 
POSTTASK:; 15-8 
PROCESSMEM: 15-53 
PUSHKEY: 15-47 
PUTCOMMON: 15-51 
PUTKEY: 15-51 
PUTMEM: 15-47 
SCRNINFO: 15-52 
SETERROR: 15-2, 15-46, 
15-49 


DESQview function 10h 


subfunction 2Bh: 15-8 
subfunction 2Ch: 15-8 
subfunction 2Dh: 15-9 


DESQview function 11h—see 


also. DESQview function 
DEnh: 15-10 

subfunction 17h: 15-10 
subfunction DEh: 15-43 


DESQview function 12h 


subfunction 03h: 15-13 
subfunction 06h: 15-29 
subfunction 07h: 15-29 


subfunction 15h: 15-42 
subfunction 16h: 15-43 
DESQview function DEh 
subfunction 00h: 
subfunction 01h: 
subfunction 02h: 15-4 
subfunction 03h: 
subfunction 04h: 
subfunction O5h: 15-4 
subfunction 06h: 15-4 
subfunction 07h: 
subfunction 08h: 15-4 
subfunction 09h: 
subfunction OAh: 15-46 
subfunction OBh: 15-46 
subfunction OCh: 15-46 
subfunction ODh: 15-47 
bi 
bi 
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subfunction OEh; 15-47 
subfunction OFh: 15-47 
subfunction 10h: 15-47 
subfunction | th: 15-48 
subfunction 12) 
subfunction 13. 
subfunction 14) 

5 

6! 





subfunction | 
subfunction | 
subfunction 17! 
50 
subfunction 18h: 15-50 
subfunction 19h; 15-50 
subfunction 1Ah: 15-51 
subfunction 1Bh: 15-51 
subfunction 1Ch: 15-51 
subfunction 1Dh: 15-51 
subfunction 1Eh: 15-52 
subfunction 1Fh: 15-52 
subfunction 20h: 15-52 
subfunction 21h: 15-52 
subfunction 22h: 15-53 
subfunction 23h: 15-53 

DESQview messages—see «also 
TopView messages: 15-13 
CONNECT: 15-13 
GETFLAGS: 15-43 
GETPRI: 15-29 
SETFLAGS: [5-42 
SETPRI: 15-29 

DESQVIEW.DVO: 15-44 

Device busy call: 3-10 

Device capabilities: 14-9 

Device CLOSE call: 8-29, 8-54, 
8-121 

Device close: 3-7 





h: 
h: 
nt 
h: 15-49 
h: 
h: 


15-49, 15- 








Device driver chain: 8-115 
Device driver lookahead flag: 
8-85 
Device driver requests: 8-119 
Device drivers: 8-48 
header: 8-54 
interrupt routine: 8-55 
strategy routine: 8-55 
Device information word: 8-29, 
8-54, 8-62 
Device mapping: 11-17, 11-21 
Device OPEN call: 8-29, 8-54, 
8-107, 8-121 
Device open: 3-7 
Device status: 8-31 
DGIS—see Direct Graphics In- 
terface Standard: 
5-45 
Diagnostics 
hard disk: 6-10, 6-11 
Digital Communications Associ- 
ates, Inc.: 29-1 
Digital Research, Inc.: 8-140, 
8-141, 36-15, 36-23 
GEM: 36-23 
Digital/Analog Converter: 5-21, 
5-22, 5-23, 5-43 
Digitized sound: 36-24 
Direct Graphics Interface Stan- 
dard 
get info: 5-45, 5-46 
redirection: 5-45 
Directory information: 8-5, 8-7, 
8-26, 8-50 
Directory searching: 8-7, 8-8, 
8-43, 8-45 
Disk buffer hash chains: 8-56 
Disk buffers; 8-5, 8-7, 8-15, 
8-26, 8-46, 8-47, 8-55, 
8-106, 8-107, 8-108, 8-109 
Disk caches: 6-27 
lelayed writes: 6-29, 6-34 
disable: 6-28 
enable: 6-28 
flush: 6-35 
ushing: 6-28, 6-33 
HyperDisk: 6-32, 6-36 
IBMCACHE: 6-27 
large-disk support: 6-33 
NetWare: 20-16 





fa 





PC-Cache: 6-34, 6-35 
Qcache: 6-28, 6-30 
SMARTDRYV: 6-36, 6-37 
status: 6-27, 6-30 
Disk change detection: 6-5 
Disk clusters—see also cluster 
numbers: 8-19 
Disk compression: 6-37 
DCOMPRES: 6-39 
NewSpace: 6-38 
Stacker: 6-38, 6-40 
Disk controllers 
4+Power: 6-7 
Adaptec: 6-22, 6-23 
diagnostics: 6-9, 6-10, 6-11 
ESDI: 6-13 
Future Domain: 6-12 
initialization: 6-8 
OMTI: 6-22 
Priam: 6-16 
SCSI: 6-12 
Western Digital: 6-4 
Disk full: 8-27 
Disk I/O; 2-5, 2-7, 6-1, 8-104 
bypassing DOS: 8-94, 8-95 
caches—see disk caches: 
6-27 
controller interrupts: 2-17 
diskette controller: 2-8 
floppies: 6-5 
formatting: 6-4, 6-5, 6-13, 
8-35 
get parameters: 6-13 
hard disks: 6-7 
initialization: 6-13 
and networks: 27-13 
read: 6-2, 6-8, 8-35 
reset: 6-1, 6-9, 6-10, 8-5 
seek: 6-9 
special disk controllers; 
6-12 
status: 6-1, 6-10 
verify: 6-3, 8-35 
Western Digital Super 
BIOS: 6-4 
write: 6-2, 6-9, 8-35 
Disk interleave: 6-7 
Disk Manager: 6-17 
Disk Parameter Block: 19-5 
Disk parking: 6-11, 6-12 
hard disk: 6-L1 
Disk redirection: 8-80, 8-81 
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Disk space determination: 8-21 
Disk Spool II: 36-15 
despooler: 36-15, 36-16 
function calls: 36-16 
installation check: 36-15, 
36-16 
menus: 36-16, 36-17 
spool file: 36-15, 36-17 
spooler: 36-15, 36-16 
Disk Transfer Area: 8-7, 8-8, 
8-9, 8-10, 8-17, 8-72, 8-76 
default: 8-15 
Disk updates, forcing: 8-70, 
8-89 
Diskette parameter table: 6-5, 
6-6 
Display combination codes: 
5-32, 5-33 
Display size: 8-98 
DISPLAY.SYS: 8-103 
installation check: 8-103 
DiVecchio, Mark: 36-32 
Divide-by-zero: 2-1 
DJ Delorie: 9-19 
DMA: 3-1, 36-28 
buffer size: 12-1 
channels: 3-2, 3-12, 6-24, 
12-5, 12-6 
Virtual DMA Specifica- 
tion—see Virtual DMA: 
12-1 
DMA errors: 6-2 
DMA translation: 12-5, 12-6 
Donnelly Software Engineering: 
36-50 
DOS 
\DEV\ prefix: 8-22 
absolute disk I/O: 8-94, 
8-95 
ASSIGN: 8-101 
available drives; 8-5 
BIOS Parameter Block: 
8-63 
boot drive: 8-20 
canonical filenames: 8-82, 
8-112, 19-13 
capitalization: 8-87, 8-88, 
8-108 
character devices: 8-112 


closing files: 8-7, 8-26, 
8-70, 8-71, 8-106, 8-113, 
19-10 

command line: 8-15 
COMMAND.COM install- 
able commands: 8-126 
commit file: 8-70, 8-89 
console: 8-3 

Control-Break handler: 
8-92 

country-specific  informa- 
tion: 8-22, 8-23, 8-85, 
8-129, 8-130 

creating files: 8-9, 8-24, 
8-68, 8-69, 8-91 

critical error flag: 8-20 
critical error handler: 8-102 
critical error: 8-93, 8-105, 
8-106 

critical sections: 27-15 
current directory structure: 
8-111 

current directory: 8-24, 
8-38, 19-3 

date: 8-16, 8-107, 8-110, 
8-111 

default drive: 8-5, 8-10 
delays; 8-112 

deleting files: 8-8, 8-27, 
19-7 

device driver chain: 8-115 
device driver lookahead 
flag: 8-85 

device drivers: 8-119 
device status: 8-31 
directory searching: 19-9, 
19-10 

disable drive: 8-82 

disk access: 8-104 

disk redirection: 8-81 

disk reset: 8-5 

disk serial number: 8-89 
disk space: 8-21, 19-5 

disk transfer area: 8-10, 
8-17 

DISPLAY.SYS: 8-103 
drive data table: 8-121 

drive information: 8-10, 
8-11 

drive mapping: 8-37 

drive parameter block: 
8-11, 8-18, 8-55, 8-56, 
8-57, 8-63 

DRIVER.SYS: 8-119 


duplicating file handles: 
8-38 

enable drive: 8-82 

error Classes: 8-67 

error codes: 8-67, 8-75, 
8-115 

error locus: 8-67 

error message tables: 8-115 
European DOS 4.0: 8-40 
EXEC state: 8-42 

EXEC: 8-40 

executing programs: 8-91 
extended error information: 
8-67, 8-75, 8-112, 8-115 
extending files: 8-13, 8-28 
fast console output: 8-96 
FASTOPEN entry point: 
8-114 

FCB: 8-5, 8-7, 8-8, 8-9, 
8-12, 8-13, 8-15, 8-16 
file attributes: 8-6, 8-7, 
8-24, 8-25, 8-28, 8-44, 
8-50, 8-51, 8-52, 8-53, 
8-59, 8-60, 8-62, 8-64, 
8-69, 8-70, 8-73, 8-142, 
19-6, 19-15 

file date: 8-65 

file locking: 8-69, 19-5 
file position; 8-9, 8-13, 
8-15, 8-27, 8-113 

file sharing modes: 8-25 
file size: 8-13 

file time: 8-65 

filenames: 8-108, 8-110, 
8-111 

FindFirst; 8-7, 8-43 
FindNext: 8-8, 8-45 
forcing disk updates: 8-70 
generic IOCTL request: 
8-37, 8-38 

global code page: 8-88 
GRAFTABL: 8-124 
GRAPHICS; 8-125 
handle limit, per process: 
8-89 

HMA: 8-125, 8-126 

idle interrupt; 8-96 
IFSFUNC: 8-126 

in HMA: 8-18, 8-20, 8-43 
in ROM: 8-18, 8-20 
InDOS flag: 8-20 

input: 8-2, 8-3, 8-4, 8-5 
installable command: 8-126 
internal services: 8-104 


i 


DOS (continued) 


IOCTL: 8-29, 8-30, 8-115, 


19-14 

KEYB: 8-127 
keyboard input: 27-16 
list of lists: 8-45 
maximum drives: 8-5 


memory allocation strategy: 


8-66 

memory allocation: 8-39, 
8-66, 9-12, 9-13, 11-8, 11-9 
multiplex functions; 8-104 
network redirector: 8-80 
NLSFUNC: 8-128 

opening files: 8-5, 8-9, 
8-24, 8-25, 8-91, 8-113, 
19-8, 19-9, 19-15 

output: 8-2, 8-3, 8-4, 8-105 
parsing filenames: 8-16 
path separators: 8-105 
PRINT.COM: 8-130 
PRINT: 8-146 

printer redirection: 8-79, 
8-80, 8-81 

printer: 8-3 

process identifier: 8-45, 
8-58, 8-70, 8-71, 8-83, 8-92 


program environment: 8-14, 


8-15, 8-18 

program exit code: 8-43 
program segment prefix: 
8-14 


program termination: 8-I, 


8-43, 8-92 

read: 8-114 

reading files: 8-8, 8-12, 
8-15, 8-26, 19-4 
real-time clock: 8-98 
record locking: 8-69 
redirected printer: 8-74, 
8-75 


redirection list entry: 8-80, 


8-81, 8-82 

reentrant functions: 8-19, 
8-20, 8-45, 8-84, 

8-85 

remote devices: 8-32 
remote drives: 8-144 
remote files: 8-7, 8-14, 
8-32, 8-52, 8-53, 8-70, 
8-144 

removable devices: 8-31 


renaming files: 8-9, 8-64, 


19-7 

server function call: 8-69 
setting error code: 8-112 
SETVER: 8-18, 8-20 
SHARE: 8-133 

sharing violations: 8-107 
SHELLB: 8-134 

special program list: 8-18 
status; 8-4 

stdaux: 8-2 


subdirectories: 8-23, 8-24, 


19-2, 19-3 


swappable data area: 8-71, 


8-75 

switch character: 8-21 
system file tables: 8-106, 
8-107, 8-109 
SYSVARS: 8-45 


terminate and stay resident: 


8-18, 8-96 
time: 8-17, 8-107 


truncating files: 8-9, 8-15, 


8-24, 8-27 
undocumented functions: 
8-11, 8-18, 8-20, 8-45, 
8-63, 8-64, 8-65, 8-66, 


8-69, 8-70, 8-71, 8-75, 
8-85, 8-87, 8-88, 8-90, 
8-98, 8-99, 8-103, 8-104, 
8-105, 8-106, 8-107, 8-108, 
8-109, 8-110, 8-111, 8-112, 
8-113, 8-114, 8-115, 8-116, 
8-119, 8-121, 8-126, 8-127, 
8-128, 8-129, 8-130, 
8-134, 8-135, 8-140, 


19-2, 19-3, 19-4, 19-5, 
19-6, 19-7, 19-8, 19-9, 
19-10, 19-11, 19-12, 
19-13, 19-14, 19-15, 


19-16 
user registers: 8-110 
verify flag: 8-17, 8-64 
version: 8-18, 8-20, 8-116 
volume label: 8-36 


wildcards in filenames: 8-7, 
8-8, 8-9, 8-10, 8-13, 8-16, 


8-27, 8-44, 8-64, 8-70, 
8-73, 8-77, 8-132 
writing files: 8-9, 8-13, 
8-15, 8-27, 19-4 
XMA2EMS.SYS: 8-140 
yes-no response: 8-87 
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DOS 5.0: 8-14, 8-18, 8-20, 8-35, 
8-37, 8-38, 8-42, 8-45, 
8-47, 8-54, 8-57, 8-66, 
8-82, 8-91, 8-102, 8-117, 
8-118, 8-121, 8-124, 8-125, 
8-126, 8-128, 8-136, 8-137, 
8-139 

DOS busy flag: 8-20 

DOS data segment: 8-47, 8-105 

DOS extenders: 9-1 
Borland: 9-21 
DOS/16M: 9-1 
Ergo: 9-20 
GO32: 9-19 
installation checks: 9-21 
OS/286:; 9-14 
OS/386: 9-14 
Phar Lap 386/DOS-Ex- 
tender: 9-1 

DOS internal services: 8-104 
close file: 8-104 
installation check: 8-104 
interrupt vectors; 8-105 

DOS Parameter List: 8-49, 8-70 

DOS Protected-Mode __Inter- 
face—see DPMI: 11-1 

DOS/16M: 9-1 
installation check: 9-1 

DOSED: 36-17 
installation check: 36-17 

DOSKEY: 8-117 
get input: 8-117 
installation check: 8-117 

DOSSHELL; 8-118 
task switcher: 8-135, 8-136, 
8-137, 8-139 

Double fault: 2-3 

Double-byte characters: 8-3, 8-4, 
8-5, 8-84 

DoubleDOS 
clear keyboard buffer: 

17-10 

installation check: 17-11 
invisible job: 17-10 
keyboard control flags: 
17-11 

menu control: 17-10 
multitasking: 17-12, 17-18 
priorities: 17-12 

program status: 17-11 
relocated IRQs: 2-14, 2-15 
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storing keystrokes: 17-10, 

17-11 

suspending jobs: 17-10 

task switching: 17-12, 

17-18 

time slices: 17-13, 17-17, 

17-18 

unknown functions: 17-17, 

17-18 

virtual screen: 17-13, 17-18 
DPMI: 9-20, 11-1 

capabilities report: 11-17 

coprocessor: 11-30, 11-31 

debug watchpoints: 11-27, 

11-28 

descriptors: 11-3, 11-4 

device mapping: 11-21 

discarding memory: 11-25 

DOS memory allocation: 

11-8, 11-9 

entry point: 11-2, 11-27 

installation check: 11-2 

local descriptor table: 11-3, 

11-7 

memory allocation: 11-18, 

11-19 

memory information: 11-21 

memory locking: 11-22, 

11-23 

memory mapping: 11-21, 

11-25 

memory status: 11-17, 

11-22 

mode switching: 11-16 

page attributes: 11-20 

page size: 11-24 

paging: 11-24, 11-25 

processor exceptions: 

11-10, 11-12 

processor mode: 11-1 

protected-mode _ interrupt 

vectors: 11-11 

real-mode callbacks: 11-15 

real-mode interrupt vectors: 

11-9 

and real-mode interrupts: 

11-13 

real-mode, calling: 11-14 

reserved functions: 11-4, 

11-24 

resident service callback: 

11-28 

segment access rights: 11-5 


segment addresses: 11-4, 
11-5 
segment aliasing: 11-6 
segment descriptors: 11-6, 
11-7, 11-8 
segment limits: 11-5 
selector offsets: 11-4 
shared memory locking: 
11-30 
shared memory: 11-29 
state saving: 11-15 
terminate and stay resident: 
11-28 
time slices; 14-4 
version check: 11-16 
virtual interrupt flag: 11-26 
DPMILOAD.EXE: 11-1 
DR DOS: 8-141, 36-1 
DR MultiUser DOS: 8-141 
Dr. Dobb’s Journal: 5-18, 5-24, 
5-26 
Drive allocation information: 
8-10, 8-11 
Drive assignments: 8-101 
Drive Data Table: 8-121 
Drive not ready: 6-2 
Drive Parameter Block: 19-12 
Drive parameter block: 8-11, 
8-18, 8-46, 8-55, 8-56, 
8-57, 8-63 
Drive size: 8-10, 8-11 
DRIVER.SYS: 8-119 
DRIVER.SYS support 
installation check: 8-119 
DTA: 8-7, 8-8, 8-9, 8-10, 8-17, 
19-4 
Dunford, Christopher J.: 36-14 
DUP call: 8-38 
DUP2 call: 8-38 
DVAVATAR.COM—see AVA- 
TAR.SYS: 36-8 
DVTMAN: 15-55 
DVTree: 15-55 
DVTXDI.COM: 15-54 
DVXMS.DVR;: 15-55 
Dynamic link libraries 
DLL manager: 35-3 
Dynamic Microprocessor Asso- 
ciates: 28-4 


Eager, Bob: 36-23 
EASY-NET 
installation check: 27-18 
EasyNet Systems, Inc.: 27-18 
EBIOS: 7-19 
break: 7-19 
initialization: 7-19 
input: 7-19, 7-20 
installation check: 7-19 
modem signals; 7-19 
status: 7-20 
EBL: 36-18 
installation check: 36-21 
keyboard buffer: 36-20 
keyboard stack: 36-20 
keyboard stuffing: 36-19 
sound: 36-18 
unknown functions: 36-18, 
36-19, 36-20, 36-21 
ECC: 6-8 
EEMS—see also EMS: 10-3 
and accelerator cards: 10-4 
page frame: 10-4 
physical window: 10-4 
EFLAGS register: 2-8 
EGA 
get info: 5-27 
print screen: 5-27 
Register Interface Library: 
5-60, 5-61, 5-62, 5-63 
vertical retrace: 2-5 
EGA Register Interface Library: 
13-1 
EGA registers: 5-60, 5-61, 5-62, 
5-63 
EGA.SYS: 8-124 
installation check: 8-124 
Eicon Access; 26-14 
EISA: 4-8 
32-bit addressing mode: 
4-10 
configuration: 4-9 
expansion slots: 4-8, 4-10 
non-volatile RAM: 4-9 
ELRES: 36-17 
installation check: 36-17, 
36-18 
EMS—see also EEMS: 10-5, 
10-9 
copying memory: 10-13 
exchanging memory con- 
tents: 10-13 


handle attribute: 10-11 

handle directory: 10-12 

handle naming: 10-11 

handles: 10-7, 10-8, 10-9, 

10-12 

hardware capabilities: 

10-14 

mappable memory: 10-14 

mapping context: 10-7, 

10-8 

mapping registers: 10-15 

memory allocation: 10-6, 

10-7, 10-8, 10-10 

memory mapping: 10-6 

memory pages: 10-6, 10-15 

page frame: 8-140, 10-4, 

10-5, 10-6, 10-14 

page mapping: 10-4, 10-6, 

10-7, 10-8, 10-9, 10-10, 10- 

12, 10-15 

raw pages: 10-15 

reserved functions: 10-8 

status: 10-5 

version check: 10-7 
Enhanced Industry-Standard Ar- 

chitecture—see EISA: 4-8 
Entry points 

Cluster Adapter: 27-20 

HIGHUMM.SYS: 36-30 

INTRSPY: 36-28 

Microsoft Windows: 14-2, 

14-5 

Omniview: 17-8 

PKTINT.COM: 27-36 

RECEIVER.COM: 19-21 

REDIRIFS: 19-23 

task switcher: 8-137 

VIDRAM: 15-60, 15-61 
Environment: 8-14, 8-15, 8-18 
EOF: 8-27, 8-29, 8-31 
Equipment list: 3-1 
Ergo Computing: 9-14, 9-21 
Ergo DOS extenders: 9-20 

installation check: 9-20 
Error codes 

Alloy MW386: 18-4 

Alloy NTNX: 18-4 

APPC/PC; 25-7 

CAS; 29-1, 29-12 

device drivers: 8-121 

DOS: 8-68, 8-75 

DPMI: 11-3 


EMS: 10-5, 10-6, 10-7, 
10-8, 10-9, 10-10, 10-11, 
10-12, 10-13, 10-14, 10-15, 
10-16, 10-17 
Intel Connection 
CoProcessor: 29-12 
Intel SatisFAXtion; 29-12 
MultiDOS: 16-2, 16-3, 16-4 
packet drivers: 27-28 
PC-IPC; 36-51 
Virtual DMA Specification: 
12-1 
XMS: 10-3 

Error messages 
DOS: 8-115 

Error-correcting code: 6-8, 6-9 

ESDI 
address translation: 6-16 
controller info: 6-16 
defect maps: 6-13 
format unit periodic inter- 
rupt: 3-4 
formatting: 6-13 
get info: 6-15 
manufacturing header: 6-14 
programmable option se- 
lect: 6-16 

ET-4000 chipset; 5-1, 5-23 

European DOS 4.0: 8-40 

Everex 
emulation control: 5-49 
memory paging: 5-49 
video modes: 5-10, 5-50 

Exact Automatisering B.V.: 35-5 
runtime interface multi- 
plexor: 35-5 

EXE file header: 8-40 

EXEC call: 8-40 

Executing programs: 8-40, 8-42, 
8-91, 36-2 

Exit code: 8-43 

Expansion slots: 4-8, 4-10 

Extended Batch Language—see 
EBL: 36-18 

Extended BIOS data area: 3-12, 
3-14 

Extended FCB: 8-7, 8-8, 8-9, 
8-10 

Extended File Control Block: 
8-6 

Extended keycodes: 8-3 
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Extended memory 
copying: 3-9 
memory size: 3-10 
Extending files: 8-13 
External Device Interface: 15-54 
DESOQview entry/exit: 
15-55 
driver custom subfunction: 
15-54 
DVP processing: 15-58, 
15-59 
installation check: 15-54 
keyboard focus: 15-57 
process start/end: 15-56 
process swapping: 15-58 
state save/restore: 15-57 
task start/end: 15-56, 15-57 
External events, waiting for: 3-5 
External monitor: 5-52, 5-53 


F-DLOCK—see F-PROT: 34-11 

F-PROT: 34-11 
F-DLOCK.EXE: 34-11 
F-DRIVER.SYS: 34-11 
F-LOCK.EXE: 34-12 
F-NET: 34-11 
F-POPUP.EXE: 34-12 
F-XCHK.EXE: 34-12 
installation checks: 34-11, 
34-12 
uninstall: 34-11, 34-12 

FAKEY.COM: 36-21 
installation check: 36-21 
keyboard stuffing: 36-21, 
36-22 
sound: 36-22 

Fast putchar: 8-96 

FASTBUFF,.COM: 36-22 
installation check: 36-22 

FASTOPEN: 8-114 

FAT—see File — Allocation 
Table: 8-12 

FAX: 29-1 

FCB—see File Control Block: 
8-5 

FCB tables: 8-46, 8-47, 8-48 

Fido/Opus/Seadog Standard. In- 
terface Level: 7-9 

File Allocation Table: 8-12, 
8-19, 8-27, 8-63 
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File attributes: 8-6, 8-7, 8-24, 
8-25, 8-28, 8-44, 8-50, 
8-51, 8-52, 8-53, 8-59, 
8-60, 8-62, 8-64, 8-69, 
8-70, 8-73, 8-142, 19-15 

File Control Block: 8-5, 8-7, 
8-8, 8-9, 8-12, 8-13, 8-15, 
8-16, 19-11 
current-record-number 
field: 8-13 
default: 8-14 
random-record field: 8-13 
random-record-number 
field; 8-13 
record-size field: 8-13 

File locking: 8-32, 8-43, 8-49, 
8-50, 8-51, 8-69, 8-71, 23-5 

File position: 8-9, 8-27, 8-38 

File sharing: 8-7, 8-25, 8-26, 
8-50, 8-52, 8-53, 8-71, 
8-72, 8-76, 8-133, 8-134, 
18-34 
delays: 8-32, 8-70 
modes: 8-25, 8-50, 8-70, 
8-91 
retries: 8-32, 8-46, 8-58 
sharing record: 8-51 
violations: 8-68, 8-93, 
8-107 

File transfer 
LapLink: 28-3 

Filename canonicalization: 8-82, 
8-112 

Filename terminators: 8-86 

Filenames: 8-105, 8-108, 8-110 
comparing: 8-111 

Files 
attributes: 8-6, 8-7, 8-24, 
8-25, 8-28, 8-44, 8-50, 
8-51, 8-52, 8-53, 8-59, 
8-60, 8-62, 8-64, 8-69, 
8-70, 8-73, 8-142, 19-15 
closing: 8-7, 8-26 
creating: 8-9, 8-24 
extending: 8-13 
opening: 8-5, 8-25 
reading: 8-8, 8-12, 8-15, 
8-26 
size: 8-13 
writing: 8-9, 8-13, 8-15, 
8-27 


FILESYS: 8-57 
FindFirst: 8-7, 8-43 
FindNext: 8-8, 8-45 
Fitzsimmons, Peter: 36-61 
Fixed disk—see hard disk: 2-7 
Flash-up Windows: 36-22 
FLASHUP.COM: 36-22 
installation check: 36-22 
Floating point emulation: 35-1 
Floppy disk: 6-5 
4+Power controller: 6-7 
change line: 6-4, 6-5 
controller interrupt: 2-8 
disk change: 6-5 
formatting: 6-4, 6-5 
get parameters: 6-3, 6-4 
interrupt relocation: 6-6, 
6-7 
motor: 6-2 
parameter table: 6-6 
read: 6-2 
reset: 6-1 
status: 6-1 
verify: 6-3 
write: 6-2 
Floppy disk drives: 3-1 
FORCEDUP call: 8-38 
Formatting disks: 6-4, 6-5, 6-7, 
6-8 
FOSSIL: 7-9 
BNU FOSSIL: 7-10 
break: 7-15 
cleanup: 7-11, 7-16 
cursor control: 7-13 
driver information; 7-15, 7- 
16 
DTR control: 7-11 
extensions: 7-18 
fake input: 7-18 
flow control: 7-13 
flush: 7-11, 7-12 
get settings: 7-11 
initialization: 7-10, 7-16 
input: 7-10, 7-12, 7-15, 
7-18 
keyboard input: 7-12 
output: 7-12, 7-15 
rebooting: 7-14 
screen output: 7-14 
status: 7-17 
timer tick processing: 7-14 


user-interrupt checking: 
7-13 
watchdog timer: 7-14 
X00: 7-16, 7-17, 7-18 

Frieze: 5-39 

FTP Software: 27-27 
NDIS packet driver: 27-34 
PC/TCP: 27-34 

Function calls 
Common Access Method: 
6-22 

Function codes 
Btrieve: 36-12 
Common Access Method: 
6-21 
DR MultiUser DOS: 8-141 
SQL Base: 36-59 

Future Domain SCSI controller 
controller info: 6-15 
get info: 6-14 
get parameters: 6-13, 6-14 
initialization: 6-13 
parking: 6-12 

FWAIT: 35-1 


Game port: 3-1, 3-8 
GDI 
information index codes: 
14-9 
information return codes: 
14-10 
GDT: 9-7 
"Gearbox"; 3-13 
GEM: 36-23 
Generic IOCTL: 8-33, 8-35 
Global descriptor table 
for extended memory copy: 
3-9 
Global Descriptor Table: 9-7 
GO32,.EXE: 9-19 
DOS extensions: 9-19 
video: 5-63 
GOLD.COM: 36-23 
installation check: 36-23 
state: 36-23 
Gonkulator: i-2 
GPI graphics: 5-36 
GRAFIX 
active page: 5-37 
active position: 5-38 
area filling: 5-38, 5-40 


clearing display: 5-37 
display pages: 5-37 
drawing function: 5-37 
drawing: 5-38, 5-40 
mode setting: 5-36 
output: 5-38 
read pixel: 5-38 
write pixel: 5-37 
GRAFTABL: 8-124 
graphics font: 8-125 
installation check: 8-124 
GRAPHICS,COM: 8-125 
installation check: 8-125 
GSS Computer Graphics Inter- 
face: 5-72 
GSS*CGI, and APL*Plus/PC: 
31-5 
Gupta Technologies: 36-59 


Halo88: 5-73 
Hanlin, Thomas G. III: 36-76 
Hard disk: 2-7, 6-7 
1024-cylinder limit: 6-2, 
6-3, 6-7, 6-8, 6-17, 6-33 
address translation: 6-16 
boot sector: 3-22 
controller info: 6-16 
controller initialization: 6-8 
controller interrupt: 2-17 
diagnostics: 6-8, 6-9, 6-10, 
6-1 
format buffer: 6-7 
formatting: 3-4, 6-7, 6-8, 
6-13 
get info: 6-14, 6-15 
get parameters: 6-3, 6-4, 
6-14, 6-17 
large-media support: 6-17 
parameter table: 6-12 
parking: 4-5, 4-6, 6-11, 
6-12 
partition record: 3-22 
partitioning: 6-16 
read: 6-2, 6-8 
recalibrate: 6-10 
reset: 6-1, 6-9, 6-10 
seek: 6-9 
status: 6-1, 6-10 
Tandy: 2-5 
verify: 6-3 
write: 6-2, 6-9 





Hard disk parameter table: 6-8, 
6-12 
Hard disk partition 
operating system indicator: 
3-22 
partition record: 3-22 
HDILOAD: 5-74 
Hercules 
GRAFIX-—-see GRAFIX: 
5-36 
and mouse: 13-2 
Hewlett Packard: 2-7, 4-11 
95LX: 2-6, 2-7, 2-8 
CMOS RAM: 4-11 
ES-12: 4-11 
HiColor DAC; 5-23 
Higgins, Donald S.: 36-51 
High Level Language API: 
20-25, 26-6, 26-14 
session parameters: 26-15 
High Memory Area; 10-1 
High memory: 8-66, 15-60 
High RAM: 8-66, 15-60 
HIGHUMM.SYS: 36-30 
HLLAPI—see High Level Lan- 
guage API 
HMA: 8-125, 8-126, 10-1 
Hongeul input mode: 8-85 
Hosgood, Steve: 36-77 
Hotkeys 
DESKTOP, PC Tools: 
33-27 
MW386; 18-36 
HP 95LX: 2-6, 2-7, 2-8 
HummingBoard: 9-20 
Huseby, Sverre H.: 36-17 
Hyperdisk 
installation check: 6-36 
large-disk support: 6-33 
unknown functions: 6-32 
HyperWare: 6-36 


I/O ports: 3-5, 6-15, 6-23 

IBM: 15-1 

IBM 3270 emulation: 26-2 

IBM 3270-PC 
High Level Language API: 
26-6 

IBM 3278 emulator 
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relocated IRQs: 2-11, 2-12, 
2-13 
IBM 802.2 interface: 27-24 
CCB: 27-24 
BM Convertible 
LCD; 5-30, 5-31 
video parameters: 5-31 
IBM Personal Communications 
3270—see PC3270: 26-5 
BM System 36/38 Workstation 
emulation: 26-1 
VDLSYS: 26-2 
BM Token Ring Adapter 
unknown functions: 27-37, 
27-38 
IBM/Yale EBIOS—see EBIOS: 
7-19 
BMCACHE 
status: 6-27 
dle interrupt: 8-96 
IFS drivers: 8-54 
IFS functions: 8-47 
IFS utility functions: 8-58 
IFSFUNC—see also network 
redirector interface: 8-126, 
19-1, 19-2, 27-15 
directories: 19-2, 19-3 
get address: 19-16 
installation check: 19-2 
IOCTL: 19-14 
opening files: 19-15 
unknown functions: 19-6, 
19-7, 19-8, 19-10, 19-14, 
19-15 
unsupported functions: 
19-10 
unused functions: 19-14 
IGC: 9-21 
Image Processing Interface: 30-1 
bitmaps: 30-2 
clearing page: 30-2 
half-toning: 30-4 
installation check: 30-1 
output device: 30-1 
palette: 30-4 
printing: 30-2 
scan lines: 30-1, 30-2 
screen image: 30-3 
version check; 30-1 
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InDOS flag: 8-20, 8-58, 8-72, 
8-76, 8-96, 18-5, 36-40, 
36-41 
and TesSeRact: 36-73 

Industrial AT: 3-12 

Information Modes: 27-21 

InnerMission: 36-24 
installation check: 36-24 

Innovative Data Concepts: 
36-61, 36-69 

INSET: 36-24 
command strings: 36-24 
configuration: 36-27 
image size: 36-25 
images: 36-27 
initialization: 36-25 
installation check: 36-24 


linked mode: 36-25, 36-26 


menus: 36-25 
merging images: 36-26 
paper motion: 36-26 
subfunction 00h: 36-24 
subfunction Olh: 36-25 
subfunction 02h: 36-25 
subfunction 03h: 36-25 
subfunction 04h: 36-25 
subfunction 05h: 36-26 
subfunction 06h: 36-26 
subfunction 07h: 36-26 
subfunction 08h: 36-26 
subfunction 09h: 36-26 
subfunction 0Ah: 36-27 
subfunction OBh: 36-27 
subfunction 0Ch; 36-27 
Installable commands: 8-126 
installation check: 8-126 
Installable file systems: 8-47, 
8-48 
Installation checks 
$25 LAN: 27-21 
3270PC: 5-35 
3com BAPI: 7-5 
4DOS: 36-1 
Alloy 386/MultiWare: 
18-14 
Alloy ANSK:; 18-14 
Installation checks 
Alloy NTNX: 18-14 
Alloy printer driver: 18-8 
ANARKEY: 36-5 
ANSI.SYS: 8-98 
APPEND: 8-99 





AppleTalk: 27-22 
ASSIGN: 8-101 

AT&T Starlan Extended 
NetBIOS: 27-12 

ATI Super Switch: 5-45 
ATI VCONFIG: 5-45 
AUTOPARKE: 6-11 
AVATAR.SYS: 36-8 
Back&Forth: 17-1, 17-2 
BACKTALK: 33-1 

Banyan VINES; 22-1 

BMB Compuscience Can- 
ada: 36-11 

BNU FOSSIL: 7-10 

CAS: 29-1 

CDROM: 19-16 

CED: 36-14 
COMMAND.COM install- 
able commands: 8-126 
COMMAND.COM _inter- 
face: 8-102 

Common Access Method: 
6-18, 6-22 

COMMUTE: 28-3 
COURIERS.COM: 7-7 
critical error handler; 8-102 
CTask: 17-10 

DATAMON, PC Tools: 
33-29 

DATAMON: 33-4, 33-29 
DCOMPRES: 6-39 
DECnet DOS CTERM: 
24-1 

DESKTOP, PC Tools: 
33-24 

DESKTOP: 33-12 
DESQview: 15-53 

Disk Spool II: 36-15, 36-16 
DISPLAY.SYS: 8-103 
DOS extenders: 9-21 

DOS internal services: 
8-104 

DOS/16M: 9-1 

DOSED: 36-17 

DOSKEY: 8-117 
DOSSHELL task switcher: 
8-137 

DoubleDOS: 17-11 

DPMI: 11-2 

DRIVER.SYS support: 
8-119 

EASY-NET: 27-18 

EBL; 36-21 


Installation checks 


EGA.SYS: 8-124 

ELRES: 36-17, 36-18 

Ergo DOS extenders: 9-20 
External Device Interface: 
15-54 

F-DLOCK: 34-11 
F-LOCK: 34-12 

F-POPUP: 34-12 

F-XCHK; 34-12 

FAKEY: 36-21 
FASTBUFF: 36-22 
FLASHUP: 36-22 
GOLD.COM: 36-23 
GRAFTABL: 8-124 
GRAPHICS.COM: 8-125 
HyperDisk: 6-36 

IBM/Yale EBIOS: 7-19 
IFSFUNC; 19-2 

Image Processing Interface: 
30-1 

InnerMission: 36-24 
INSET: 36-24 

INTRSPY: 36-27 

IPX: 20-23 

Jetstream: 36-29 

KEYB: 8-127 

LANtastic: 27-13 

LPTx: 36-32, 36-33 
MAKEY: 36-35 
MANIFEST: 15-59 
Microsoft CD-ROM Exten- 
sions: 19-1 

Microsoft Windows: 14-1, 
14-6 

MSCDEX: 19-1 
MSHERC.COM: 5-60 
MultiLink Advanced: 17-17 
NetBIOS, alternate inter- 
face: 27-13 

NetWare SPX: 20-30 
network redirector inter- 
face: 19-2 

network: 27-13, 27-18 
NewSpace: 6-38 
NLSFUNC: 8-128 

Novell LSL.COM: 20-25 
Novell NASI: 7-23 

packet drivers: 27-27 

PC LAN Program: 19-1 

PC Network: 19-21 

PC Tools scheduler: 33-2 
PC-Cache: 6-34, 6-35 


PC3270: 26-5, 26-12 
pcANY WHERE: 28-4, 
28-7 


Installation checks 


PCRUN, PC Tools: 33-19 
PCShell: 33-17 

PCSpool: 36-49 

Phar Lap: 9-20 

PRINT; 8-131 
PUSHDIR: 36-49 
Qcache: 6-29 
QEMM-386: [5-60 
QRAM: 15-60 
Quarterdeck programs: 
15-59 

RAID: 36-52 
REDIRIFS.EXE: 19-22 
Register Interface Library: 
5-63 

RESPLAY: 36-53 
SCRNSAV2.COM: 5-71 
SCROLOCK: 36-54 
SCSI: 6-18, 6-22 
SHARE: 8-133 

SHELLB: 8-134 
SPEEDSCR: 36-59 
Stay-Res: 36-46 
SWBIOS: 6-17 

SWELL: 36-61 

TAME: 36-65 

task switcher: 8-137 
TBSCANX: 34-13 
TeleReplica: 28-7 

TES: 7-20 

TesSeRact: 36-69 
ThunderByte: 34-14 
TKERNEL:; 9-21 
TopView: 15-6 

Topware Network Operat- 
ing System: 27-19 

TRAP: 36-75 
TurboPower TSRs: 36-75, 
36-76 

Ungermann-Bass Net One: 
7-23 

VCPI: 10-17 

VDEFEND: 33-29 
VEGA VGA; 5-46 
VIDCLOCK: 36-76 
Video 7 VGA; 5-46 
VIDRAM: 15-60 


viruses: 34-1, 34-2, 34-3, 
34-4, 34-5, 34-6, 34-7, 
34-8, 34-9, 34-10 
VMix: 17-2 
VUIMAGE: 5-18 
WATCH: 36-76 
WCED: 36-77 
WHOALI: 36-77 
WILDUNIX: 36-77 
Word Perfect Third-Party 
Interface: 36-78 
XDI drivers: 15-55 
XDV: 15-43 
XMA2EMS: 8-140 
XMS: 10-1 
ZIPKEY: 32-1 
nstance data: 8-139 
NT 00h: 2-1 
INT Oth: 2-1 
INT 02h: 2-2 
INT 03h: 2-2 
Function 4647h: 36-55 
NT 04h: 2-2 
NT 05h: 2-2, 3-1 
INT 06h; 2-3 
INT O7h: 2-3 
NT 08h: 2-3 
NT 09h; 2-3, 2-4 
INT OAh: 2-4, 2-5 
INT OBh: 2-5, 2-6 
INT 0Ch: 2-6, 26-1 
INT ODh: 2-6, 2-7 
INT OEh: 2-7, 2-8 
INT OFh: 2-8 
INT 10h: 2-8 
Function 00h; 5-1, 5-10, 5- 
11 
Function Oth: 5-12 
Function 02h: 5-12 
Function 03h: 5-13 
Function 04h: 5-13 
Function 05h: 5-13, 5-14 
Function 06h: 5- 
Function 07h: 5-1 
Function 08h: 5-1 
Function 09h: 5-1 
Function 0Ah; 5-1 
Function OBh: 5- 
Function 0Ch: 5- 
Function ODh: 5- 
Function 0Eh: 5- 
Function OFh;: 5- 
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Funetion 10h: 5-18, 5-19, 
5-20, 5-21, 5-22, 5-23 
Function 1 1h: 5-24, 5-25, 
5-26 

Function 12h: 5-26, 5-27, 
5-28, 5-29 

Function 13h: 5-30 
Function 14h: 5-30, 5-31 
Function 15h: 5-31, 5-32 
Function | Ah: 5-32 
Function 1Bh: 5-33 
Function 1Ch: 5-35 
Function 30h: 5-35 
Function 40h: 5-36 
Function 41h: 5-36 
Function 42h: 5-37 
Function 43h: 5-37 
Function 44h: 5-37 
Function 45h: 5-37 
Function 46h: 5-37 
Function 47h: 5-38 
Function 48h: 5-38 
Function 49h: 5-38 
Function 4Ah: 5-38 
Function 4Bh; 5-38, 5-39 
Function 4Ch: 5-40 
Function 4Dh: 5-40 
Function 4Eh: 5-40 
Function 4Fh: 5-41, 5-42, 
5-43, 5-44 

Function 50h: 36-54 
Function 51h; 36-54 
Function 55h: 5-45 
Function 6Ah; 5-45, 5-46 
Function 6Fh: 5-46, 5-47, 
5-48 

Function 70h: 5-48 
Function 7000h: 5-49, 5-50 
Function 71h: 5-50 
Function 72h: 5-51 
Function 73h: 5-51 
Function 80h: 5-51 
Function 81h: 5-51 
Function 82h; 5-52 
Function 8Bh; 18-1 
Function 90h: 18-1 
Function 91h: 18-1 
Function 92h: 18-2 
Function 93h: 18-2 
Function BFh: 5-52, 5-53, 
5-54 

Function CCh; 5-55 
Function CDh: 5-56, 5-57, 
5-58, 5-59 








INT 11h: 2-8, 3- 


INT 12h; 3-2 


INT 13h 


Function EFh: 5-60 
Function FOh: 5: 
Function Fth: 5: 
Function F2h: 5 
Function F3h: 5- 
Function F4h: 5: 
Function F5h: 5. 
Function F6h: 5. 
Function F7h: 5: 
Function FAh: 
36-22 
Function FEh: 15-1 


3 
-63, 13-1, 


Function FFh: 5-63, 15-2, 


28-1 


Function BCh: 7-10 
Function FFh: 17-1 


Function FFh: 17-1 


Function 00h: 6-1 
Function O1h: 6-1 
Function 02h: 6-2 
Function 03h: 6-2 
Function 04h: 6-3 
Function 05h: 6-5 
Function 06h: 6- 
Function O7h: 6- 
Function 08h: 6- 
Function 09h: 6- 
Function OAh: 6- 
Function OBh; 6- 
Function 0Ch: 6- 

6- 

6- 














Function 0Dh: 
Function OEh: 
Function OFh: 6-10 
Function 10h: 6-10 
Function 11h; 6-10 
Funetion 12h: 6-10, 6-12 
Function 13h: 6-11 
Function 14h: 6-11 
Function 15h: 6-4 
Function 16h: 6-5 
Function 17h: 6-5 
Function 18h: 6-4, 6-13 
Function 19h: 6-11, 6-13 
Function 1 Ah: 6-13, 6-14 
Function 1Bh: 6-14 
Function 1Ch: 6-15, 6-16 
Function 1Dh: 6-27 
Function 20h: 6-4, 6-28 
Function 21h: 6-28 
Function 22h: 6-28 


INT 14h 


Function 24h: 6-28 
Function 25h: 6-29 
Function 27h: 6-29 
Function 2Ah: 6-29 
Function 2Ch: 6-29 
Function 2Dh: 6-29 
Function 2Eh: 6-30 
Function 30h: 6-30 
Function 70h: 6-16 
Function 75h: 6-30 
Function 76h: 6-30 
Function 81h: 6-30 
Function 82h: 6-31 
Function 83h: 6-31 
Function 84h: 6-31 
Function 85h: 6-31 
Function 8Eh: 6-32 
Function AOh: 6-32 
Function Alh: 6-33 
Function A2h: 6-33 
Function ADh: 6-16 
Function BOh: 6-33 
Function EEh: 6-17, 6-33 
Function F9h: 6-17 
Function FEh: 6-17 





flush: 7-9 
Function 00h: 7-1, 7-10 
Function Oth: 7-1 
Function 02h: 7-2, 7-10 
Function 03h: 7-2 








Function 04h: 7-3, 7-10, 


16-1 


Function O5h: 7-3, 7-11, 


16-1 
Function 06h: 7-11, 16-1 
Function 07h: 7-11, 16-2 
Function 08h; 7-11, 16-2 
Function 09h: 7-11, 16-2 
Function OAh: 7-12 

Function OBh: 7-12 

Function OCh: 7-12 

Function ODh: 7-12 

Function OEh: 7- 
Function OFh: 7- 
Function [0h: 7-1 
Function 11h: 7- 
Function 12h: 7- 
Function 13h; 7- 
Function 14h: 7- 
Function 15h: 7- 
Function 16h: 7- 
Function 17h: 7- 
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Function 18h: 7-15 
Function 19h: 7-15 
Function 1Ah: 7-6, 7-7, 
7-15 

Function 1Bh: 7-15 
Function 1Ch: 7-16 
Function 1Dh: 7-16 
Function 1Eh: 7-16 
Function LFh: 7-17 
Function 20h: 7-18, 16-2, 
18-2 

Function 21h: 7-18, 16-3, 
18-2 
Function 22h: 16-3, 18-2 
Function 23h: 16-3, 18-3 
Function 24h: 16-4, 18-3 
Function 25h; 16-4 
Function 27h: 16-4 
Function 7Eh: 7-18 
Function 7Fh; 7-18 
Function 80h: 7-7 
Function 81h: 5-64, 5-70, 
7-7 
Function 82h: 7- 
Function 83h: 
Function 84h: 
Function 85h: 7- 
Function 86h: 
Function 87h: 
Function 88h: 





7. 
7 
Function 89h: 7- 
Function 8Ah: 7- 
Function 8Ch: 7- 
Function 8Dh: 7- 
Function AOh: 7- 
Function Alh: 7- 
Function A2h: 7- 
Function A3h: 7- 
Function A4h: 7-4, 
Function A5h: 7-4, 
Function A6h: 7- 3,7. 
7-5, 

7-2: 

5 


, 7-20 
7-20 


Function A7h: 
Function A8h: 
Function AFh: 7-. 
Function BOh: 7-5 
Function Bih: 7-5 
Function F4h: 7-19 
Function F9h: 7-19 
Function FAh: 7-19 
Function FBh: 7-19 
Function FCh: 7-19 
Function FDh: 7-20 
Function FFh: 7-20 
output: 7-9 





INT 15h 


Function 00h: 3-2, 4-1, 
16-4, 17-2 

Function 01h: 3-2, 4-1, 
16-5, 17-2 

Function 02h: 3-3, 4-2, 
6-5, 17-2 

Function 03h: 3-3, 4-2, 
6-5, 17-3 

Function 04h: 3-3, 4-2, 
16-5, 17-3 

Function 05h: 3-4, 4-3, 
16-6, 17-3 
Function 06h: 4-3, 16-6, 
7-3 
Function 07h: 16- 
Function 08h: 16~ 
Function 09h: 16- 


NAS 
me 
ay 
RRW 





Function 0Ah: 16-7, 17-4 
Function OBh: 16-7, 17-4 
Function OCh: 16-7, 17-4 
Function 0Dh; 16-8, 17-5 
Function OEh: 16-8, 17-5 
Function OFh: 3-4, 16-8, 


7-5 
Function 10h: 15-2, 15-3, 
5-4, 15-5, 15-6, 15-7, 
15-8, 15-9, 16-8, 17-5 
Function 11h: 15-10, 15-43, 
6-9, 17-5 
Function 12h: 15-10, 15-11, 
15-12, 15-13, 15-14, 15-15, 
15-16, 15-17, 15-29, 15-30, 
15-31, 15-32, 15-33, 15-34, 
5-35, 15-36, 15-37, 15-38, 
15-39, 15-40, 15-41, 15-42, 
15-43, 16-9, 17-6 
Function 13h: 16-9, 17-6 
Function 14h: 16-10, 17-6 
Function 15h: 16-11, 17-6 
Function 16h: 16-11, 17-6 
Function 17h: 16-11, 17-7 
Function 18h: 16-12, 17-7 
-7 
7 
7 
7 





Function 19h: 16-12, 1 
Function 1Ah: 16-12, 1 
Function 1Bh: 16-12, 1 
Function 1Ch: 16-13, 1 
Function 1Dh: 16-13, 17-8 
Function 1Eh: 16-13, 16- 
14, 17-8 

Function 1Fh: 16-14 
Function 20h: 3-4, 8-130, 
16-14 


7- 
7- 
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Function 21h: 
Function 40h: 
Function 41h: 
Function 42h: 
Function 43h: 
Function 44 
Function 46h 
Function 4F! 
Function 54 
Function 80 
Function 8 
Function 82h: 
Function 83h: 
Function 84h: 
Function 85h: 
Function 86h: 
Function 87h: 
Function 88h: 
Function 89h: 
Function 90h: 
Function 91h: 
Function BCh: 
Function BFh: 
Function COh: 
Function Cih: 
Function C2h: 
3-16 
Function C3h: 3-16 
Function C4h: 3-17 
Function C5h: 3-17 
Function C6h: 3-17 
Function C7h: 3-17 
Function C8h; 3-17 
Function C9h: 3-17 
Function CAh: 3-17 
Function CBh; 3-17 
Function CCh: 3-17 
Function CDh: 3-17 
Function CEh: 3-17 
Function CFh; 3-17 
Function D8h: 4-8, 4-9, 
4-10 

Function DEh: 15-43, 
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15-44, 15-45, 15-46, 15-47, 
15-48, 15-49, 15-50, 15-51, 


15-52, 15-53 

Function E0h: 4-6 
Function Eth: 4-6 
Function E2h: 4-7 


INT 16h 


Function 00h: 3-17 
Function O1h: 3-18 
Function 02h: 3-18 


Function 03h: 3-18 
Function 04h: 3-19 
Function 05h: 3-19 
Function 10h: 3-19 
Function 11h: 3-20 
Function 12h: 3-20 
Function 45h: 27-1, 27-2, 
27-3 

Function 55h: 36-46, 36-61 
Function 6969h: 33-1 
Function 6Fh: 14-1 
Function 70h: 36-21 
Function 71h: 36-21 
Function 72h: 36-22 
Function 73h: 36-22 
Function 75h: 28-4 
Function 76h: 28-4 
Function 77h: 28-4, 36-49, 
36-76 
Function 79h: 
Function 7Ah: 
Function 7Bh: 28- 
Function 7Ch: 28-: 
Function 7Dh: 28-~ 
Function 7Eh: 28- 
Function 7Fh: 28- 
Function 80h: 36- 
Function AAh: 
Function E0h: 
Function FOh: 
Function Fih: 
Function F2h: 
Function F3h: 4-8 

Function F4h:; 4-8 

Function FEh: 33-1, 33-2 
Function FFA5h: 6-34, 6-35 
Function FFh—see also PC 
Tools: 33-3, 33-4, 33-5, 
33-6, 33-7, 33-8, 33-9, 33- 
10, 33-11, 33-12, 33-13, 33- 
14, 33-15, 33-16, 33-17, 
33-18, 33-19, 33-20, 33-21, 
33-22, 33-23, 33-24, 33-25, 
33-26, 33-27, 33-28 


SN 
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INT 17h 


Function 00h: 3-20 
Function O1h: 3-21 
Function 02h: 3-21, 36-24 
Function OABCh: 36-32 
Function OB90h: 36-32 
Function OB91h: 36-32 
Function OFS5Fh: 36-33 


1-20 


Function 24h: 27-3, 27-4, 


27-5, 27-6 
Function 60h: 36-22 
Function 61h: 36-59 





Function 81h: 18-4 
Function 82h: 18-5 
Function 83h: 18-5 
Function 84h: 18-5 
Function 87h: 18-5 
Function 88h: 18-6 
Function 89h: 18-6 
Function 8Ah: 18-6 
Function 8Bh: 18-7 
Function 8Ch: 18-7 
Function 8Dh: 18-7 
Function 8Eh: 18-7 


Function 8Fh: 1 
Function 90h: I 
Function 91h: 1 
Function 92h: 1 
Function 94h: 
Function 95h: 
Function 96h: 18-9 
Function 97h: 
Function 98h: 
Function 99h: 18-10 
Function 9Ah: 18-11 
Function 9Bh: 18-11 
Function AOh: 18-12 
Function A4h: 18-12 
Function A6h; 18-12 
Function A7h: 18-13 
Function A8h: 18-13 
Function A9h: 18-13 
Function AAh: 18-13 
Function AFh: 18-14 
Function COh: 36-47 
Function C1h: 36-48 
Function C2h: 36-48 
Function C3h: 36-48 
Function C4h: 36-49 
Function CSh: 36-49 
Function C6h: 36-49 
Function C7h: 36-49 
Function CDh: 36-24, 
36-25, 36-26, 36-27 
Function FOh: 36-29 
Function F1h: 36-29 
Function F2h: 36-29 
Function F3h: 36-29 
Function F4h: 36-29 
Function F5h: 36-30 





INT 18h: 3-21 


INT 19h; 3-21 

INT 1Ah 
Function 00h: 3-23 
Function 01h: 3-23 
Function 02h; 3-23 
Function 03h: 3-24 
Function 04h: 3-24 
Function 05h: 3-24 
Function 06h: 3-24 
Function 07h: 3-25 
Function 08h: 3-25 
Function 09h: 3-25 
Function OAh: 3-25 
Function OBh: 3-26 
Function 36h: 36-78 
Function 80h: 3-26 
Function AOh: 36-15 
Function ABh: 36-15 
Function ACh: 36-16 
Function ADh: 36-16 
Function DOh: 36-16 
Function FEh: 4-3 
Function FFh: 4-3 

INT 1Bh: 3-26 

INT 1Ch: 3-26 

INT 1Dh: 5-71 

INT 1Eh: 6-6 

INT 1Ph: 5-71 

INT 20h: 8-1, 36-47 

INT 2th 
and APPEND: 8-100 


Function O1h: 8- 
Function 02h: 8- 
Function 03h: 8~ 
Function 04h: 8- 
Function OSh:; 8- 
Function 06h: 8- 
Function 07h: 8- 
Function 08h: 8- 
Function 09h: 8- 
Function OAh: 8- 
Function OBh: 8- 
Function O0Ch: 8-: 
Function ODh: 8- 
Function OEh: 8-. 
Function OFh: 8- 
Function 10h: 8~- 
Function 11h: 8~ 
Function 12h: 8- 
Function 13h: 8- 
Function 14h: 8- 
Function 15h: 8- 


Function 16h: 8-9 
Function 17h: 8-9 
Function 18h: 8-10 
Function 19h: 8-10 
Function 1Ah: 8-10 
Function 1Bh: 8-10 
Function 1Ch: 8-11 
Function 1Dh: 8-11 
Function 1h: 8-11 
Function 1Fh: 8-11 
Function 20h: 8-12 
Function 21h: 8-12 
Function 22h; 8-13 
Function 23h: 8-13 
Function 24h; 8-13 
Function 25h: 8-13, 9-1, 





9-2, 9-3, 9-4, 9-5, 9-6, 9-7, 
9-8, 9-9, 9-10, 9-11, 9-12, 


9-13, 

Function 26h: 8-14 
Function 27h: 8-15 
Function 28h: 8-15 
Function 29h: 8-16 
Function 2Ah: 8-16 


Function 2Bh: 6-35, 8-16, 


15-53, 28-7, 36-17, 36-65 
Function 2Ch: 8-17 
Function 2Dh: 8-17 
Function 2Eh: 8-17 
Function 2Fh: 8-17 


Function 30h: 8-18, 9-14, 


17-10, 34-1 
Function 31h: 8-18 
Function 32h: 8-18 


Function 33h: 8-19, 8-20, 


34-1 

Function 34h: 8-20 
Function 35h: 8-21, 34-2 
Function 36h: 8-21 
Function 37h: 8-21, 8-22 
Function 38h: 8-22, 8-23 
Function 39h: 8-23 
Function 3Ah: 8-24 
Function 3Bh: 8-24 
Function 3Ch: 8-24 
Function 3Dh: 8-25 
Function 3Eh: 8-26 
Function 3Fh: 8-26 
Function 40h: 8-27 
Function 41h: 8-27 
Function 42h: 8-27, 34-2 
Function 43h: 8-28 


Function 44h: 6-36, 6-37, 


6-38, 6-39, 8-29, 8-30, 


8-31, 8-32, 8-33, 8-35, 
8-37, 8-38, 8-140, 8-141, 
26-2, 27-6, 36-30 

Function 45h: 8-38 
Function 46h: 8-38 
Function 47h: 8-38 
Function 48h: 8-39 
Function 49h: 8-39 





Function 4Ah: 8-39 
Function 4Bh: 8-40, 8-42, 
34-2, 34-3, 34-11, 36-18 
Function 4Ch: 8-43 
Function 4Dh: 8-43 
Function 4Eh: 8-43, 36-77 
Function 4Fh: 8-45 
Function 50h; 8-45 
Function 51h: 8-45 
Function 52h: 8-45, 34-3 
Function 53h: 8-63 
Function 54h; 8-64 
Function 55h: 8-64 
Function 56h: 8-64 
Function 57h: 8-65, 8-66 
Function 58h: 8-66, 34-3 
Function 59h: 8-67 
Function 5Ah; 8-68 


Function 5Bh: 8-69 
Function 5Ch: 8-69 
Function 5Dh: 8-69, 8-70, 
8-71, 8-74, 8-75, 

21-1 

Function 5Eh: 8-78, 8-79, 
8-80, 21-1 

Function 5Fh: 8-80, 8-81, 
8-82, 8-144, 8-145, 21-1, 
21-2, 21-3, 21-4, 21-5, 21- 
6, 21-7, 21-8, 21-9, 21-10, 
21-11, 21-12, 21-13, 27-11 
Function 60h: 8-82 
Function 61h: 8-83 
Function 62h: 8-83 
Function 63h: 8-84, 8-85 
Function 64h: 8-85 
Function 65h: 8-85, 8-87, 
8-88 

Function 66h; 8-88 
Function 67h; 8-89 
Function 68h: 8-89 
Function 69h: 8-89 
Function 6Ah; 8-90 
Function 6Bh: 8-90, 8-91 
Function 6Ch: 8-91 
Function 76h: 34-3 
Function 80h: 8-91 


Function 83h; 34-3 
Function 87h: 8-92 
Function 89h: 8-92, 34-4 
Function 90h: 34-4 
Function 97h: 34-4 
Function AOh: 26-2 
Function Alh: 26-3, 34-4 
Function A2h: 26-3 
Function A3h: 26-3 
Function A4h: 26-4 
Function A5h: 26-4, 34-4 
Function ABh: 34-4 
Function AFh; 26-4 
Function BS5h: 20-1 
Function B6h: 20-2 
Function B8h: 20-2, 26-5 
Function BBh: 20-3 
Function BCh: 20-3 
Function BDh: 20-4 
Function BEh: 20-4, 34-4, 
34-5 

Function BFh: 20-4 
Function COh: 20-4, 34-: 
Function Clh: 20-5, 34-. 
Function C2h: 20-5, 34-: 
Function C3h: 20-5, 34-: 
Function C4h: 20-5 
Function C5h: 20-6, 34- 
Function C6h: 20-6, 34- 
Function C7h: 20- 
0-' 
0- 





6 
Function C8h: 20-7 
Function C9h: 20-7 
Function CAh: 20-7, 
Function CBh; 20-8 
Function CCh: 20-8, 
Function CDh: 20-8, 
Function CEh: 20-8 
Function CFh: 20-9, 27-12 
Function DOh: 20-9, 22-1, 
34-6 

Function D1h: 20-9, 22-1 
Function D2h: 20-9, 22-1 
Function D3h: 20-10, 22-1 
Function D4h: 20-10, 22-1 
Function DSh; 20-10, 22-1, 
34-7 

Function D6éh: 20-10 
Function D7h; 20-11 
Function D8h: 20-11, 22-1 
Function D9h: 20-11, 22-1 
Function DAh: 20-11 
Function DBh: 20-12 
Function DCh: 6-39, 20-12, 
22-1 


421 


Function DDh: 20-12, 34-7 
Function DEh: 20-12, 34-7 
Function DFh: 20-13 
Function EQh: 9-14, 17-10, 
20-13, 34-8 
Function Elh: 9-14, 17-10, 
20-14, 34-8 
Function E2h: 9-15, 17-10, 
20-14 
Function E3h: 9-15, 17-11, 
20-15 
Function B4h: 9-15, 17-11, 
20-17, 34-8 
Function ES5h: 9-16, 17-11, 
20-17 
Function E6h: 9-16, 20-18 
Function E7h: 9-16, 20-18, 
22-1, 34-8 
Function E8h: 9-16, 17-11, 
20-18, 20-19 ‘ 
Function E9h: 9-17, 17-12, 
20-18, 20-19 
Function EAh: 9-17, 17-12, 
20-20 
Function EBh: 9-17, 9-18, 
9-19, 17-12, 20-20 
Function ECh; 9-19, 17-13, 
20-20, 34-8 

Function EDh: 9-19, 20-21 
Function EEh; 17-13, 20- 
21, 34-9 

Function EFh: 20-21 
Function FOh: 17-13, 20-22, 
34-9 

Function Flh: 17-13, 20-22, 
34-9 

Function F2h: 17-13, 20-23 
Function F3h; 17-13, 20-23 
Function Fah; 17-13 
Function F5h; 17-13 
Function F8h: 17-13 
Function F9h: 17-13 
Function FAh: 17-13, 33- 
28, 34-14 

Function FBh: 17-13, 34-9 
Function FCh: 17-13 
Function FEh: 6-39, 17-13, 
34-9, 34-10 

Function FFh: 9-19, 27-12, 
34-10, 36-14, 36-17 








INT 22h: 8-92 
INT 23h: 8-92 
INT 24h: 8-93 





| 
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i 
| 
i 
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i 
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INT 25h: 6-40, 8-94 
Function FFh: 6-35 
Function FFFFh: 8-94 

INT 26h: 8-95 
Function FFFFh: 8-95 

INT 27h: 8-96 

INT 28h: 8-96 

INT 29h: 8-96 

INT 2Ah: 21-13 
Function 00h: 
Function O1h: 27-13 
Function 02h: 27-13 

Function 03h: 27-13 

Function 04h; 27-14 

Function 05h: 27-14 

Function 06h: 27-14 
Function 20h: 27-14 
Function 80h: 27-15 
Function 81h: 27-15 
Function 82h; 27-15 
Function 84h: 27-16 
Function 87h: 27-16 
Function 89h: 27-16 
Function 90h: 26-5 
Function C2h: 27-16 

INT 2Bh: 8-97 

INT 2Ch: 8-97, 8-145 

INT 2Dh: 8-97 

INT 2Eh: 8-97 
Function E22Eh: 36-1 

INT 2Fh:; 36-11 





: 27-12, 27-13 


Function 00h: 8-130, 8-131 
Function Oth; 8-131, 8-132, 
8-133 

Function 02h: 19-1 
Function 05h: 8-102 
Function 06h: 8-101 
Function 08h: 8-119, 8-121 
Function 10h: 8-133, 8-134 
Function 11h: 19-1, 19-2, 
19-3, 19-4, 19-5, 19-6, 19- 
7, 19-8, 19-9, 19-10, 19-11, 
19-12, 19-13, 19-14, 19-15, 
19-16, 27-16 

Function 12h: 8-104, 8-105, 
8-106, 8-107, 8-108, 8-109, 
8-110, 8-111, 8-112, 8-113, 
8-114, 8-115, 8-116 
Function 13h: 8-104 
Function 14h: 8-128, 8-129, 
8-130 


Function 15h: 8-125, 19-16, 
19-17, 19-18, 19-19, 19-20, 
19-21 

Function 16h: 11-1, 11-2, 
14-1, 14-2, 14-3, 14-4, 
14-5, 14-6 

Function 17h: 14-6, 14-7, 
14-8, 14-9 

Function 19h: 8-134, 8-135 
Function 1Ah: 8-98, 8-99, 
36-8, 36-9, 36-10, 36-11 
Function 1Bh: 8-140 
Function 40h: 8-146 
Function 41h: 27-17 
Function 42h: 27-17 
Function 43h: 10-1 
Function 46h: 8-117, 14-6, 
34-11, 34-12 

Function 48h: 8-117 
Function 4Ah: 8-118, 
8-125, 8-126 

Function 4Bh: 8-136, 
8-137, 8-139, 27-17 
Function 5453h: 36-69, 
36-70, 36-71, 36-72, 36-73, 
36-74 

Function 55h; 8-102 
Function 62h: 33-29, 34-14 
Function 64h: 5-71 
Function 7Ah: 20-23, 20-24 
Function 7Fh: 36-51 
Function 80h: 27-18 
Function 82h: 36-53 
Function 89h: 36-77 
Function 90h: 36-52 
Function 93h: 36-24 
Function Alh: 9-20 
Function AAh: 36-76 
Function ACh: 8-125 
Function ADh: 8-103, 
8-127, 8-128, 8-146 
Function AEh: 8-126 
Function BOh; 8-124, 8-125 
Function B4h: 26-5, 26-6 
Function B7h: 8-99, 8-100, 
8-101 

Function B8h: 21-13, 
27-18, 27-19 

Function B9h: 19-21, 19-22 
Function BCh: 8-124 
Function BFh: 19-22, 19-23 
Function COh: 20-25 
Function C9h; 34-14 


Function CAh: 34-13, 
34-14 

Function CBh: 29-1, 29-3, 
29-4, 29-5, 29-6, 29-7, 
29-8, 29-9, 29-12, 29-13, 
29-14 

Function CDh: 30-1, 30-2, 
30-3, 30-4, 36-61, 36-62, 
36-63 

Function DOh: 36-35, 
36-36, 36-37 
Function Dih: 36-38, 
36-39, 36-40, 36-41, 36-42 
Function D2h: 15-59, 15-60 
Function D3h: 28-3, 28-7 
Function D44Dh: 36-1, 36- 
2, 36-3 
Function D44Eh: 36-3 
Function D7h: 22-1 
Function DAh: 36-75 
Function DCh: 36-23 
Function DEh: 15-54, 
15-55, 15-56, 15-57, 15-58, 
15-59 

Function DFh: 6-36 
Function E3h: 36-5, 36-6, 
36-7, 36-8 

Function EDh: 9-20 
Function Fih; 9-21 
Function F7h: 6-11 
Function FBA 1h: 9-21, 
9.22 

Function FBh: 11-1 
Function FFh: 27-19, 27-20 





INT 30h; 8-98 
INT 31h; 8-98 


Function 00h: 11-3, 11-4, 
11-5, 11-6, 11-7, 11-8 
Function Oth: 11-8, 11-9 
Function 02h: 11-9, 11-10, 
11-11, 11-12 

Function 03h: 11-13, 11-14, 
11-15, 11-16 

Function 04h: 11-16, 11-17 
Function 05h: 11-17, 11-18, 
11-19, 11-20, 11-21, 11-22 
Function 06h: 11-22, 11-23, 
11-24 

Function 07h: 11-24, 11-25 
Function 08h: 11-25 
Function 09h: 11-26 
Function OAh: 11-27 
Function OBh: 11-27, 11-28 





Function 0Ch: 11-28 


Function ODh: 11-29, 11-30 
Function OEh: 11-30, 11-31 


INT 32h: 34-10 

INT 33h 
Function 0000h: 13-1 
Function 000th: 13-2 
Function 0002h: 13-2 
Function 0003h: 13-2 
Function 0004h; 13-2 
Function 0005h: 13-3 

Function 0006h:; 13-3 

Function 0007h: 13-3 


Function 0008h: 13-4 
Function 0009h: 13-4 
Function 000Ah: 13-4 
Function 000Bh: 13-5 
Function 000Ch: 13-5 
Function 000Dh: 13-5 
Function OOO0Eh: 13-6 
Function O00Fh: 13-6 


Function 0010h: 
Function 0012h: 
Function 0013h: 
Function 0014h: 
Function 0015h: 
Function 0016h: 
Function 0017h: 
Function 0018h: 
Function 0019h: 
Function 001 Ah: 
Function 001Bh: 
Function 001Ch: 13- 
Function 001Dh: 13-9 
Function 001Bh: 13-10 
Function 0OLFh: 13-10 
Function 0020h: 13-10 
Function 0021h: 13-10 
Function 0022h: 13-11 
Function 0023h: 13-11 
Function 0024h: 13-11 
Function 0026h: 13-12 
Function 002Ch: {3-12 
Function 002Dh: 13-12 
Function 0042h: 13-16 
Function 004Dh: 13-12 
Function 0050h: 13-16 
Function 0052h: 13-16 
Function 006Dh: 13-13 
Function 1D6Ch: 13-13 
Function 1E6Ch: 13-13 
Function 1F6Ch: 13-13 
Function 206Ch: 13-13 





y 
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Function 216Ch: 13-14 
Function 226Ch: 13-14 
Function 236Ch: 13-14 
Function 246Ch: 13-14 
Function 256Ch: 13-15 
Function 266Ch: 13-15 
Function 276Ch: 13-16 

INT 34h: 35-1 

INT 35h: 35-1 

INT 36h: 35-1 

INT 37h: 35-1 

INT 38h: 35-2 

INT 39h: 35-2 

INT 3Ah: 35-2 

INT 3Bh: 35-2 

INT 3Ch: 35-2 

INT 3Dh; 35-2 

INT 3Eh: 35-3 

INT 3Fh: 35-3 

INT 40h: 2-9, 6-6 

INT 41h: 2-9, 6-12 

INT 42h: 2-9, 5-72 


INT 51h: 2-11 

INT 52h: 2-12 

INT 53h: 2-12 

INT 54h: 2-12, 2-13 

INT 55h; 2-13 

INT 56h: 2-13 

INT 57h: 2-13, 2-14 

INT 58h: 2-14 

INT 59h: 2-14, 5-72 

INT S5Ah; 2-14, 27-20 

INT 5Bh: 2-14, 2-15, 18-14, 
27-20, 27-21 
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INT 5Ch: 2-£5, 27-21, 27-24, 


27-27 

Function 04h; 27-21 
INT 5Dh: 2-15 
INT 5Eh: 2-15 
INT 5Fh: 2-15, 2-16 


INT 60h: 4-4, 6-22, 26-6, 27-27, 
34-10, 35-4, 36-27, 36-50, 


36-51 





INT 43h: 2-9, 5-72 

INT 44h: 2-9, 5-72, 20-25, 26-6 
INT 45h: 2-9 

INT 46h: 2-9, 6-12 

INT 47h; 2-10 


Function 80h: 36-59, 36-61 


INT 48h: 2-10, 3-26 
INT 49h; 2-10, 3-26, 4-12 


Function 0001h: 36-33 
Function 0002h: 36-33 
Function 0003h: 36-33 
Function 0004h: 36-34 
Function 0005h: 36-34 
Function 0006h: 36-34 
Function 0007h: 36-35 


INT 4Ah: 2-10, 3-27 


IN1 


INI 
INT 
IN 
INI 


[ 4Bh: 2-10, 6-17 


Function 81h: 12-1, 12-2, 


12-3, 12-4, 12-5, 
12-6 
Function 80h: 6-18 

[ 4Ch: 2-10 

[ 4Dh: 2-10 

[ 4Eh: 2-10, 6-4 

[ 4Ph: 2-11 
Function 8100h: 6-18 
Function 8200h: 6-22 





IN] 





E 50h: 2-11, 27-20 


Function 00h: 36-43, 36-64 
Function OLh: 27-27, 36-43, 
36-64 

Function 02h: 27-29, 36-44, 
36-64 

Function 03h: 27-29, 36-44, 
36-64 

Function 04h: 27-29, 36-45, 
36-64 

Function 05h: 27-30, 36-45 
Function 06h: 27-30, 36-45 
Function 07h: 27-30 
Function 0Ah; 27-30 
Function OBh; 27-31 
Function O0Ch; 22-1, 27-31 
Function 1fh: 22-2, 23-1, 
27-32 

Function 12h; 22-2, 23-1, 
27-32 

Function 13h: 22-2, 23-1, 
27-32 

Function 14h: 27-32 
Function 15h: 27-33 
Function 16h: 27-33 
Function 17h: 27-33 
Function 18h: 27-34 
Function 19h: 27-34 


INT 61h: 4-4, 6-22, 26-6, 27-34, 


35-4 
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Function 0001h: 22-2, 22-3, 
22-4, 22-5, 22-6, 22-7 


Function 77h: 36-20 
Function 78h: 36-20 


Function 5Ch: 10-16 
Function 5Dh: 10-17 








Function 0002h: 22-7 Function 79h: 36-20 Function 60h: 10-4 
Function 0003h: 22-12 Function 7Ah: 36-20 Function 61h: 10-4 
Function 0004h: 22-16 Function 7Bh: 36-20 Function 68h: 10-4 
Function 0005h: 22-17 Function 7Ch: 36-20 Function 69h: 10-4 
Function 0007h: 22-17, Function 7Dh: 36-20 Function 6Ah: 10-4 
22-18, 22-19 Function 7Eh: 36-21 Function DEh: 10-17, 
Function 0008h: 22-20, Function 7Fh: 36-21 10-18, 10-19, 10-20 
22-21 INT 65h: 6-23, 27-34, 36-3, INT 68h: 26-7 
Function 000Ah: 22-21 36-54 Function 01h: 25- 
Function O1h: 22-22 Function 0000h: 36-4 Function 02h: 25-4 
Function 02h: 22-22 Function 0003h: 36-4 Function 03h: 25-7 
INT 62h: 6-22, 36-61 Function 0004h: 36-4 Function 04h: 25-8 
Function 01h: 17-13 Function 0006h: 36-5 Function 05h: 25-9 
Function 02h: 17-13 Function 0007h: 36-5 Function 06h: 25-9 
Function 03h: 17-14 Function 000Ch: 36-5 Function 07h: 25-10 
Function 04h: 17-14 Function O0ODh: 36-5 Function FAh: 25-10 
Function 05h: 17-14 INT 66h: 6-23 Function FBh: 25-10 
Function 06h: 17-14 Function 06h: 36-24 Function FCh: 25-11 
Function 07h: 17-14 Function FEh: 36-45, 36-46 Function FDh: 25-11 


Function 08h: 17-15 INT 67h: 6-23, 26-6 Function FEh: 25-11 


Function 09h: 17-15 Function 00h: 27-35 Function FFh: 25-12 
Function OAh: 17-15 Pinction OTR D7 ae INT 69h: 4-12 

Function OBh: 17-15 Function 02h: 27-35 Function Olh: 24-1, 24-2, 
Function 0Ch; 17-15 Function 40h: 10-5 24-3, 24-4 


Funetion ODh: 17-16 Function 41h: 10-6 INT 6Ah: 24-4, 36-47 

Function OEh: 17-16 Function 42h: 10-6 Function 01h: 24-4 
Function OFh: 17-16 Function 43h: 10-6 Function 02h: 24-4 
Function 10h; 17-16 Function 44h: 10-6 Function 03h: 24-4 











Function 11h: 17-16 Function 45h: 10-7 Function DOh: 24-5 
Function 12h: 17-17 Function 46h: 10-7 Function D1h: 24-5 
Function 13h: 17-17 Function 47h: 10-7 Function D3h: 24-5 
Function 47h: 28-2 Function 48h: 10-8 Function D4h: 24-6 
Function 48h: 28-2 Function 49h: 10-8 Function D5h: 24-6 


Function 49h: 28-2 Function 4Ah: 10-8 
Function 4Ah: 28-2 Function 4Bh: 10-8 
Function 4Bh: 28-2 Function 4Ch: 10-8 
Function 4Ch: 28-3 Function 4Dh: 10-9 
Function 62h: 28-3 Function 4Eh: 10-9 
INT 63h: 6-7, 6-22, 9-22 Function 4Fh: 10-10 
INT 64h: 6-23, 9-22, 20-25, Function 50h: 10-10 
36-18 Function 51h: 10-10 
Function 6Dh: 36-18 Function 52h: 10-11 
Function 6Eh: 36-18 Function 53h: 10-11 
Function 6Fh; 36-19 Function 54h: 10-12 
Function 70h: 36-19 Function 55h: 10-12 
Function 71h: 36-19 Function 56h: 10-12 
Function 72h: 36-19 Function 57h: 10-13 
Function 73h: 36-19 Function 58h: 10-14 
Function 74h: 36-19 Function 59h: 10-14 
Function 75h: 36-20 Function 5Ah: 10-15 
Function 76h: 36-20 Function 5Bh; 10-15, 10-16 


Function D6h: 24-6 

INT 6Bh: 20-25, 34-11, 36-68 
Function 00h; 7-22 
Function Olh: 7-22 
Function 02h: 7-23 
Function 06h: 7-23 
Function 07h: 7-23 

INT 6Ch: 3-27, 8-98 

INT 6Dh: 5-72, 5-73, 24-6 

INT 6Eh: 24-6 

INT 6Fh: 4-11, 20-25 
Function 00h: 23-1 
Function 01h: 23-2 
Function 02h; 23-2 
Function 03h: 23-3 
Function 04h: 23-4 
Function 05h: 23-4 
Function 07h: 23-5 
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Function 08h: 23-5 Function 0009h: 20-29 Function 21h: 18-28 
Function 09h: 23-5 Function 000Ah: 20-29 Function 22h: 18-29 | 
Function 0Ah: 23-6 Function 000Bh: 20-29 Function 24h: 18-29 | 
Function OBh; 23-6 Function 000Ch: 20-30 Function 25h: 18-29 | 
Function 0Ch: 23-6 Function 000Dh: 20-30 Function 26h; 18-30 
Function 0Dh: 23-7 Function 000Eh;: 20-30 Function 30h: 18-30 
Function OEh: 23-7 Function 00OFh: 20-30 Function 31h; 18-31 
Function 10h: 23-9 Function 0010h: 20-30 Function 37h: 18-31 
Function 11h; 23-9 Function 001 1h: 20-30 Function 38h: 18-31 
Function 12h: 23-10 Function 0012h: 20-31 Function 39h: 18-32 
Function 13h: 23-10 Function 0013h:; 20-31 Function 3Ah: 18-32 
Function 14h: 23-10 Function 0014h: 20-32 Function 3Bh: 18-32 
Function 15h: 23-10, 23-11 Function 0015h: 20-32 Function 3Ch: 18-32 i 
Function 17h: 23-11 Function 0016h: 20-32 Function 3Dh: 18-33 i 
Function 18h: 23-12 Function 0017h: 20-33 Function 41h: 18-33 ‘ 
INT 70h: 2-16, 34-11 Function 0018h: 20-33 Function 42h: 18-33, 18-34 \ 
INT 71h: 2-16 Function 0019h: 20-33 Function 43h: 27-36 | 
INT 72h: 2-16 Function 001 Ah; 20-33 Function 4Eh; 18-34 
INT 73h: 2-16 Function 001Bh; 20-33 Function 4Fh; 18-34 | 
INT 74h: 2-16 Function 04h: 26-7 Function 81h; 18-34 i 
INT 75h: 2-17 Function 06h: 26-7 Function 82h; 18-35 
INT 76h: 2-17 Function 09h; 26-7, 26-8, Function AOh: 18-35 | 
els 26-9, 26-10, 26-11 Function Alh: 18-35 { 
INT 77h: 2-17 Function 13h: 26-11 Function A2h: 18-35 
INT 78h Function 8th: 26-11 Function A3h: 18-36 } 
Function 00h: 6-23 Function 83h: 26-12 Function A4h; 18-36 i 
Function O1h: 6-23 Function FDh: 26-12 Function ASh: 18-36 
Function 02h: 6-24 Function FEh: 26-12, 26-13 Function BOh: 18-36 i 
Function 03h: 6-24, 9-22 Function FFh: 26-13 Function Blh: 18-37 i 
Function 04h: 6-24 INT 7Bh: 26-14, 36-12 Function B2h: 18-37 
Function 05h: 6-24 INT 7Eh: 5-73, 18-14 Function B3h: 18-37 i 
Function 06h: 6-24 Function 00h: 18-14 Function B4h: 18-37 
Function 08h: 6-25 Function Olh: 5-74, 18-15, Function C3h: 18-38 
Function 09h: 6-25 26-14 Function C5h; 18-38 
Function 10h: 6-25 Function 02h: 18-15 Function C6h; 18-38 
Funetion th: 6-26 Function 03h: 18-15 Funetion C7h: 18-38 
Function 12h: 6-26 Function 04h: 18-15 Funetion C8b: 18-39 
Function 13h: 6-26 Function 05h: 18-16 Function Ch: 18-39 
Function 14h: 6-26 Function 06h: 18-17 Function Doh: 18-39 
Function 15h: 6-27 Function O7h: 18-18 Function D7h: 18-39 | 
Function 1Bh: 9-23 Function 08h: 18-18 Function D8h: 18-39 | 
Function 22h: 9-23 Function 09h: 17-17, 18-19 Function DBh: 18-40 
INT 79h: 36-11 Function OAh: 18-19 Function E0h: 18-40 
INT 7Ah: 20-25, 27-35, 36-8 Function OBh: 18-20 Function Eth: 18-40 i 
Function 0000h: 20-26 Function 10h: 18-20, 18-21, Function E2h: 18-40 | 
Function 0001h: 20-26 18-22, 18-23 Function E3h: 18-41 
Function 0002h: 20-26 Function 11h: 18-23 Function E4h; 18-41 
Function 0003h: 20-27 Function 12h: 18-23 Function E5h: 18-41 | 
Function 0004h: 20-28 Function 13h: 18-24 Function E6h: 18-41 | 
Function 0005h: 20-28 Function 14h: 18-24, 18-25, Function E7h: 18-42 i 
Function 0006h: 20-28 18-26 Function E8h: 18-42 | 
Function 0007h: 20-29 Function 15h: 18-26, 18-27 Function FOh: 18-42 
Function 0008h:; 20-29 Function 16h: 18-28 Function Fih: 18-42 





Function F2h: 18-43 
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Function F3h: 18-43 
Function F8h: 18-43 
Function F9h: 18-43 
Function FAh: 18-44 
Function FBh: 18-44 
Function FCh: 18-44 

INT 80h; 36-52 
Function 0000h: 36-55 
Function 0001h: 36-55 
Function 0002h: 36-56 
Function 0003h: 36-56 
Function 0004h: 36-56 
Function 0005h: 36-56 
Function 0006h: 36-57 
Function 0007h: 36-57 
Function 0008h: 36-57 
Function 0009h: 36-57 
Function QOO0Ah: 36-57 
Function QOOBh: 36-58 
Function Oth: 27-36 
Function 02h: 27-36 
Function 03h: 27-36 
Function 04h: 27-37 
Function 05h: 27-37 
Function 06h: 27-37 

INT 81h: 27-37 

INT 82h: 27-37 

INT 86h; 27-38, 31-1 

INT 87h: 31-1 

INT 88h 
Function 00h; 31- 
Function O1h: 31- 
Function 02h: 31- 
Function 08h: 31- 
Function FSh: 31- 
Function F6h: 31- 
Function F7h: 31- 
Funetion F8h: 31- 
Function F9h: 31-3 
Function FCh: 31-4 
Function FDh; 31-4 
Function FEh: 31-4 
Function FFh: 31-4 

INT 8Ah: 31-4 

INT 8Bh: 31-5 

INT 8Ch: 31-5 

INT 90h: 31-5 

INT 91h: 27-38 

INT 92h: 27-38 

INT 93h: 27-38 

INT 95h: 31-5 

INT AOh: 31-5 


WWHWWNNNE 


INT A4h: 36-54 
INT B3h 


Function 70h: 32-1 
Function 71h: 32-1 
Function 72h; 32-1 
Function 73h: 32-2 
Function 74h: 32-2 
Function 75h: 32-2 
Function 76h: 32-2 
Function 77h: 32-3 
Function 78h: 32-3 
Function 79h: 32-3 
Function 7Ah: 32-3 
Function 7Bh: 32-4 
Function 7Ch: 32-4 
Function 7Dh: 32-4 
Function 7Eh; 32-4 
Function 7Fh: 32-5 
Function 80h: 32-5 





INT C6h: 31-5 
INT C7h: 31-5 
INT C8h: 31-5 
INT C9h: 31-5 
INT CAh: 31-5 
INT CBh: 31-5 
INT CCh: 31-5 
INT CDh: 31-6 
INT CEh: 31-6 
INT CFh: 31-6 
INT DOh: 31-6 
INT D1h: 31-6 
INT D2h: 31-6 
INT D3h:; 31-6 
INT D4h: 31-6 
INT D5h:; 31-6 
INT D6h: 31-6 
INT D7h: 31-6 
INT D8h; 31-6 
INT D9h: 31-6 
INT DAh: 31-6 
INT DBh: 31-6 
INT DCh: 31-6, 36-51 
INT DDh: 31-6 
INT DEh: 31-6 
INT DFh: 4-12, 31-6 


INT EOh: 31-7, 34-11, 36-15 


INT Eth: 27-38 
INT E2h: 27-38 
INT E4h 


Function 00h: 35-4 


INT ECh: 18-44, 35-5 
INT EFh: 35-5 


Function 0473h: 36-23 
INT FOh: 35-5 
INT Fih: 36-58 
INT F2h: 36-58 
INT F4h: 17-17 
INT FSh: 17-17 
INT F6h: 17-17 
INT F7h: 17-17 
INT F8h: 17-17 
INT F9h: 17-17 
INT FAh: 17-18 
INT FBh: 17-18 
INT FCh: 17-18 
INT FDh: 17-18 
INT FEh:; 17-18 
INT FFh: 4-12 
Intel Connection CoProcessor: 
29-9, 29-10, 29-11 
failure codes: 29-12 
Intel Corporation: 29-1 
Intel SatisFAXtion: 29-11, 
29-12 
failure codes; 29-12 
Interconnections,Inc—see TES: 
7-20 
Intergalactic Digital Research— 
see Digital Research, Inc.: 
36-23 
Interim console flag: 8-3, 8-4, 
8-5, 8-85 
Internal modems: 3-2, 3-6 
Internal monitor: 5-52, 5-53 
Interrupt enable flag: 11-26 
nterrupt List: i-3 
nterrupt request: i-] 
nterrupt vectors: 8-13, 8-21, 
8-105, 11-9, 33-25, 36-75 
DESKTOP: 33-27 
mterrupts 
reserved: i-2 
NTRSPY: 36-27 
entry point: 36-28 
installation check: 36-27 
Invalid opcode exception: 2-3 
OCTL: 8-115 
device control channel: 
8-30 

















device information: 8-29 
device status: 8-31 
file sharing: 8-32 
generic request: 8-33, 8-35, 
8-37, 8-38 
remote device: 8-32 
remote file; 8-32 
removable: 8-31 
subfunction 00h: 8-29 
subfunction OLh: 8-29 
subfunction 02h: 6-36, 
8-30, 26-2, 27-6, 36-30 
subfunction 03h: 6-37, 8-30 
subfunction 04h: 8-30 
subfunction 05h: 8-30 
bfunction 06h: 8-31 
bfunction 07h: 8-31 
bfunction 08h: 8-31 
bfunction 09h; 8-32 
subfunction OAh; 8-32 
bfunction OBh: 8-32 
bfunction OCh: 8-33 
bfunction ODh: 8-35 
bfunction OEh; 8-37 
subfunction OFh:; 8-37 
subfunction 10h; 6-38 
subfunction 11h: 6-38 
subfunction 12h: 6-38 
6-39 
6-39 





subfunction 13h: 
subfunction 14h: 
subfunction 51h: 8-140 
subfunction 52h; 8-141 
subfunction FFh; 6-39 

IPX: 20-25 
events: 20-28, 20-29 
installation check: 20-23 
interval marker: 20-29 
network address: 20-26 
network connections: 20-29 
network data transfer: 
20-30 
sockets: 20-26 
unknown functions: 20-30, 
20-33 

IRQ mapping: 9-4, 10-19, 11-17, 
16-11, 16-12 

IRQO: 2-3, 2-11, 2-14 

TRQ10: 2-14, 2-16 

IRQ11: 2-15, 2-16 

IRQ12; 2-15, 2-16 

IRQ13: 2-15, 2-17 

IRQ14: 2-15, 2-17 

IRQIS: 2-16, 2-17 


c=f 





IRQS: 2-7, 2-13, 2 

IRQG6: 2-8, 2-13, 2 

IRQ7; 2-8, 2-13, 2- 

IRQ8: 2-14, 2-16 

IRQ9: 2-14, 2-16 

IRQs: i-2, 13-11 
relocation: 2-11, 2-12, 2-13, 
2-14, 2-15, 2-16 

Isaacson, Eric: 32-1 

Isogon Corporation: 6-38 





Jetstream: 36-28 
aborting: 36-29 
completion handler: 36-29 
installation check: 36-29 
printing: 36-29, 36-30 
progress report: 36-29 

JFT; 8-14, 8-111 

Job file table; 8-14, 8-111 

JOIN: 8-46, 8-53, 8-83 

Joystick: 3-8, 4-2 

JP Software: 36-1 

JPI TopSPEED—see also 
TopSPEED Modula-2: 35-4 


Kanji: 19-19 
Kemp, Stuart: 5-74 
Kermit: 36-23 
Key Software Products: 36-30 
KEYB;: 8-127 
code page: 8-128 
installation check: 8-127 
keyboard mappings: 8-128 
Keyboard 
clear buffer: 17-10 
input: 7-12 
interrupt ready interrupt: 
keyboard type: 4-7 
keyclick: 3-19 
reading keystrokes: 3-17, 
3-19 
scancode translation: 3-6, 
3-26 
shift flags: 3-18, 3-20 
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store keystroke: 17-10, 
17-11 
storing keystrokes: 3-19 
testing for keystrokes: 3-18, 
3-20, 
TopView field mode: 
15-15, 15-16, 15-33, 15-36, 
15-38, 15-41 
typematic: 3-18 
Keyboard stuffing: 36-74 
EBL: 36-19, 36-20 
FAKEY: 36-21, 36-22 
Keyclick: 3-19 
KEYSTACK.SYS: 36-1 
Keystroke availability: 8-4 
Kokkonen, Kim: 36-76 


LAN Manager: 27-11, 27-16 
encryption; 27-17 
messenger service: 27-17 
named pipes: 27-17 
NETWKSTA.EXE: 27-17 
pop-up service; 27-17 
redirector: 27-17 

LANstep: 27-12 

LANtastic: 21-1 
account expiration: 21-3 
accounts: 21-3, 21-10 
audit trail: 21-8 
direct disk I/O: 27-13 
DOS service vector: 21-12 
file copying: 21-3 
function 80h; 21-1 
function 81h: 21-1 
function 82h: 21-2 
function 83h: 21-2 
function 84h; 21-2 
function 85h: 21-2 
function 86h: 21-3 
function 87h: 21-3 
function 97h: 21-3 
function 98h: 21-4 
function 99h: 21-4 
function 9Ah: 21-4 
function 9Bh: 21-5 
function 9Ch: 21-5 
function AOh: 21-5 
function Alh: 21-6 
function A2h: 21-6 
function A3h:; 21-7 
function A4h: 21-7 
function ASh: 21-8 
function A7h: 21-8 
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‘unction BOh: 21-8 
unction B 1h: 21-9 
function B2h: 21-10 
function B3h: 21-10 
unction B4h: 21-10 
unction B5h: 21-11 
unction COh: 21-11 
‘unction DOh: 21-11 
unction Dih: 21-12 
unction EOh: 21-12 
unction Elh: 21-12 
‘unction E2h: 21-12 
‘unction E3h; 21-13 
indirect files: 21-10, 21-11 
installation check: 27-13 
logins: 21-1, 21-2 


message processing: 21-4, 
21-5 
message service: 21-12, 
21-13 
messages: 21-4, 21-5 
NetBIOS, alternate inter- 
face: 21-13 
passwords: 21-1, 21-2, 21-3 
printer timeouts: 21-11, 
21-12 
printers: 21-7 
queues: 21-5, 21-6 
servers, inactive: 21-2 
shared directories: 21-9 
streams: 21-7, 21-8 
symbolic links: 21-10, 
21-11 
system time; 21-11 
usernames: 21-2, 21-10 
users, active; 21-8 
version check; 21-13 
LANtastic Network Operating 
System—see  LANtastic: 
21-1 
LapLink: 28-3 
DeskConnect: 28-3 
Quick Connect—see 
DeskConnect: 28-3 
LASTBYTE.SYS: 36-30 
LASTDRIVE=: 8-5, 8-46, 8-47, 
8-48 
LCD: 3-6, 5-30, 5-31 
LDT: 9-4, 9-6, 9-7, 9-8, 9-9, 
11-3, 11-7 
Lead byte table: 8-84 
Light pen: 5-13, 5-30, 5-34, 5-46 





emulated by mouse: 13-5, 
13-6 

LIM EMS—see EMS: 10-5 

LIM EMS 4.0—see EMS: 10-9 

Line editing: 4-4 

Line editor: 8-4 

Line input: 8-4 

Line status: 16-3 

LINK.EXE: 35-3 

Linkers: 8-41 

List of lists: 8-45 

Local Descriptor Table: 9-4, 9-6, 
9-7, 9-8, 9-9, 11-3, 11-7 

Logical drive map: 8-37 

Logitech: 35-4 

Logitech Modula-2: 35-4 

Logitech Mouse: 13-13 
ballistics: 13-13, 13-14 
buttons: 13-15 
compass parameter: 13-13 
emulation type: 13-15 
emulation: 13-16 
handedness: 13-13, 13-14 
middle button: 13-3 
parameters: 13-14, 13-15 
resetting driver: 13-14 
serial parameters: 13-15 
signature string: 13-2 
uninstall: 13-14 
version check: 13-15 

LPT 1—see printer: 2-8 

LPT2: 2-7 

LPTx: 36-32 
installation check: 36-32, 
36-33 

LSL.COM 
installation check: 20-25 





MAGic; 36-33 
magnification: 36-33 
screen size: 36-34 
window position: 36-33, 
36-34 
window size: 36-35 

Magnified displays: 36-33 

MAKEY: 36-35 
installation check: 36-35 

MANIFEST 
installation check: 15-59 

Mapping memory: 4-4 

MARK: 36-76 


Master Reference List: 1-2 

McGuire, Andy C.: 36-58 

MDEBUG: 36-35 
commands: 36-39, 36-40, 
36-41 
driver status: 36-35, 36-38 
flags: 36-45 
help registers: 36-43 
hotkey: 36-43, 36-44 
initialization: 36-36, 36-38, 
36-42 
INT 2Fh vector: 36-42 
multiplex number: 36-43 
password: 36-43, 36-44, 36- 
45 
popping up: 36-44, 36-45 
reserved functions: 36-37, 
36-41, 36-42 
screen saving: 36-36, 36-37 
status: 36-43, 36-44 
termination: 36-42 
user-defined functions: 
36-37, 36-42 

Media ID byte: 8-10, 8-11, 8-19, 
8-63 

Memory addressing 
video paging: 5-14 

Memory allocation: 8-1, 8-18, 
8-39, 8-66, 8-72, 8-76, 
11-8, 11-9 

Memory caching: 4-8 

Memory control block: 8-46 

Memory copying: 10-13 

Memory limits: 10-17 

Memory locking: 11-30 

Memory management: 36-30 

Memory mapping: 9-3, 11-17, 
11-21, 11-25 

Memory size: 3-2, 3-10, 8-14 

Menus: 4-4 

Meridian Technology, Inc.: 28-1 

Metafile: 14-10 

Mickey: 13-5 

Micro Channel bus: 3-12 

Micro Cornucopia: 36-64 

MicroHelp—see Stay-Res Plus: 
36-45 

Microsoft CD-ROM _ Exten- 
sions—see MSCDEX: 19-1 


Microsoft Corporation: 27-6, 
35-1, 36-61 
floating point emulation: 
35-1, 35-2 

Microsoft Mouse: 13-1 

Microsoft Network Transport 
Layer Interface: 27-21 

Microsoft Windows: 14-1 
critical sections: 14-4 
device API: 14-5 
device call-outs: 14-3 
enhanced mode: 14-1, 14-3, 
14-4 
entry points: 14-2, 14-5 
initialization: 14-2, 14-3 
installation check: 14-1, 
14-6 
termination: 14-3, 14-4 
time slices: 14-4 
unknown functions: 14-1 
virtual device IDs: 14-5 
virtual machines: 14-5, 14-6 
WinOldAP-—see 
WinOldAp: 14-6 

Microsoft Word: 36-46 
keyboard TSR check: 36-46 

Microsystems Software, Inc.: 
36-33 

MIDI: 2-5 

Minix: 36-46, 36-47 

Mode switch: 10-20 

Mode switching: 3-10, 11-16 

Model byte: 3-12 

Modem: 4-6 

Modem status: 16-3 

Modula-2; 35-4 

Monochrome display: 5-15 

Mouse: 13-1 
acceleration profile: 13-7, 
13-12, 13-13, 13-14 
alternate user handlers: 
13-8 
Amstrad: 4-1 
ballistics: 13-13, 13-14 
button presses: 13-3 
button release: 13-3 
buttons: 4-2, 13-2, 13-3 
compass parameter: 13-13 
copyright string: 13-12 
cursor definition: 13-4, 13-6 
cursor: 13-6 
and DESQview: 15-9 








disabling driver: 13-10 
double-speed threshold: 
13-7, 13-9 
driver state: 13-7, 13-8, 
13-16 
enabling driver: 13-10 
event handlers: 13-5, 13-7, 
13-8 
handedness: 13-13, 13-14 
initialization: 13-1 
InPort: 13-9, 13-11 
interrupt rate: 13-9, 13-15 
language: 13-11 
light pen emulation: 13-5, 
13-6 
messages: 13-11 
mickeys: 13-5, 13-6 
motion sensitivity: 13-6, 
13-9 
motion: 13-5 
mouse cursor: 13-2 
mouse type: 13-11 
position limits: 13-3, 13-4 
position: 13-2, 13-5 
rapid motion: 13-7 
resetting driver: 13-1, 
13-10, 13-14 
scaling factor: 4-2 
and screen updates; 13-6 
service routine call mask: 
13-5 
uninstall: 13-14 
version check: 13-11 
video page: 13-9, 13-10 
virtual device: 14-5 

Mouse, Logitech: 13-13 

Mouse, Mickey: 13-6 

Mouse, Microsoft: 13-1 

Mouse droppings: 13-2 

Mouse Systems PCMOUSE:; 
13-16 
driver state: 13-16 
middle button: 13-3 

MS Windows; 8-39 
DOSX DOS extender: 8-1, 
8-6, 8-7, 8-9, 8-12, 8-13, 8- 
15 

MSCDEX—see network 
redirector interface: 19-1 
installation check: 19-1 
version check: 19-19 

MSDOS compatibles: 8-140 
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MSHERC.COM 
installation check: 5-60 

MultiDOS Plus: 16-1 
command prompt: 16-10 
command strings: 16-8 
critical sections: 16-8 
error codes: 16-2, 16-3, 
16-4 
events: 16-13, 16-14 
hotkey: 16-9 
initialization: 16-11 


interprocess communica- 


tion: 16-5, 16-6 


IRQ mapping: 16-11, 16-12 


mailboxes: 16-6 
memory statistics: 16-14 
multitasking: 16-8, 16-14 
screen output: 16-7 
semaphores: 16-5, 16-8, 
16-12, 16-13 
serial port 
buffers; 16-4 
deactivating: 16-4 
V/O: 16-1, 16-3 
initialization: 16-1, 16-2 
input status: 16-4 
reset: 16-2 
status: 16-2, 16-3, 16-4 
status codes; 16-2, 16-3 
suspending tasks; 16-5 
system block: 16-11 
task control block: 16-9 
task priority: 16-7 
threads: 16-6 
time slices: 16-4 
interval: 16-7 
MultiLink Advanced 
installation check: 17-17 
task priorities: 17-17 
Multiplex function 00h; 8-130 
subfunction 80h: 8-131 
Multiplex function 01h: 8-131 
subfunction 00h: 8-131 
subfunction 01h: 8-131 
subfunction 02h; 8-132 
subfunction 03h; 8-132 
subfunction 04h: 8-132 
subfunction 05h: 8-133 
subfunction 06h: 8-133 
Multiplex function 02h: 19-1 
subfunction 00h: 19-1 
Multiplex function 05h: 8-102 
Multiplex function 06h 
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subfunction 00h: 8-101 


subj 


Multiplex function 08h 


sub! 
sub! 
sub 
sub 


Multiplex function 10h 


sub 
sud: 
sud: 
sub: 





function Olh: 8-101 


function OOh: 8-119 
function Oh: 8-119 
function 02h: 8-119 
function 03h: 8-121 


function OOh: 8-133 
function 40h: 8-134 
function 80h: 8-134 
function 81h: 8-134 








Multiplex function 11h 


sub 
sub! 


sub 
sub 
sub 
sub 





‘unction OOh: 19-1, 19-2 
‘unction O1h: 19-2 
‘unction 02h: 19-2 
‘unction 03h: 19-2 
‘unction 04h: 19-3 
‘unction OSh: 19-3 
unction 06h: 19-3 
‘unction 07h: 19-4 
function O8h: 19-4 
function 09h: 19-4 
function OAh; 19-5 
function OBh: 19-5 
unction OCh: 19-5 
‘unction ODh: 19-6 
‘unction OEh; 19-6 





subfunction OFh: 19-6 


sub! 
sub: 
sub’ 
sub 
sub: 
sub: 
sub: 
sub: 
sub 
sub 
sub 
sub 


unction 10h: 19-7 
unction 11h: 19-7 
unction 12h; 19-7 
function 13h; 19-7 
function 14h: 19-8 
function 15h: 19-8 
function 16h: 19-8 
function 17h: 19-8 
function 18h: 19-9 
function 19h: 19-9 
function 1Ah: 19-10 
function 1Bh; 19-10 





subfunction 1Ch: 19-10 


subi 
sub: 
sub: 
sub! 
sub: 
sub 
sub 
sub 
sub: 
sub 
sub 


function 1Dh: 19-10 
function 1Eh; 19-11 
function 1Fh: 19-11 
function 20h: 19-12 
function 21h: 19-12 
function 22h; 19-12 
function 23h: 19-13 
function 24h: 19-13 
function 25h: 19-13 
function 26h: 19-13 
function 27h: 19-14 





subfunction 28h: 19-14 
subfunction 29h: 19-14 
subfunction 2Ah: 19-14 
subfunction 2Bh: 19-14 
subfunction 2Ch: 19-14 
subfunction 2Dh: 19-15 
subfunction 2Eh: 19-15 
subfunction 2Fh: 19-15 
subfunction 30h: 19-16 
subfunction 86h: 27-16 
subfunction 8Ah: 27-16 
subfunction 8Fh: 27-16 


Multiplex function 12h 


subfunction 00h: 8-104 
subfunction 01h: 8-104 
subfunction 02h: 8-105 
subfunction 03h: 8-105 
subfunction 04h: 8-105 
subfunction 05h: 8-105 
subfunction 06h: 8-105 
subfunction 07h; 8-106 
subfunction 08h: 8-106 
subfunction 09h: 8-106 
subfunction OAh: 8-106 
subfunction OBh: 

subfunction O0Ch: 
subfunction ODh: 
subfunction OEh: 
subfunction OFh: 8-108 
subfunction 10h: 8-108 
subfunction 11h: 8-108 
subfunction 12h; 8-108 
subfunction 13h: 8-108 
subfunction 14h: 8-109 
subfunction 15h: 8-109 
subfunction 16h: 8-109 
subfunction 17h: 8-109 
subfunction 18h: 8-110 
subfunction 19h: 8-110 
subfunction 1Ah: 8-110 
subfunction 1Bh: 8-110 
subfunction 1Ch:; 8-110 
subfunction 1Dh: 8-111 
subfunction 1Eh; 8-111 
subfunction 1Fh: 8- 
subfunction 20h: 8-1 
subfunction 21h: 8- 
subfunction 22h: 8- 
subfunction 23h: 8- 
subfunction 24h: 8- 
subfunction 25h: 8- 
subfunction 26h: 8- 
subfunction 27h: 8- 























WHWWNNNYN 


Multiplex function 17h 


subfunction 28h: 8-113 
subfunction 29h: 8-114 
subfunction 2Ah: 8-114 
‘unction 2Bh: 8-115 
bfunction 2Ch: 8-115 
bfunction 2Dh: 8-115 
bfunction 2Eh: 8-115 
bfunction 2Fh: 8-116 
ex function 13h: 8-104 
ex function 14h 
subfunction 00h: 8-128 

Ib: 

bi 

bi 

Dd! 

e 


a 
i= 
g 


unction OLh: 8-129 
unction 02h; 8-129 
‘unction 03h; 8-129 
‘unction 04h: 8-130 
x function 15h 

subfunction 00h: 8-125, 
19-16 
subfunction 01h: 19-16 
subfunction 02h: 19-16 
subfunction 03h; 19-17 
subfunction 04h: 19-17 
subfunction 05h: 19-17 
subfunction 06h: 19-17 
subfunction 07h: 19-18 
subfunction 08h: 19-18 
subfunction 09h: 19-18 
subfunction OAh: 19-18 
subfunction OBh: 19-18 
subfunction 0Ch: 19-19 
subfunction ODh: 19-19 
subfunction OBh: 19-19 
subfunction OFh: 19-20 
subfunction 10h: 19-21 











Multiplex function 16h 


subfunction 00h: 14-1 
subfunction 02h: 14-2 
subfunction OSh: 14~ 
subfunction 06h: 14- 
subfunction 07h: 14- 
subfunction 08h: 14- 
subfunction 09h: 14~ 
subfunction 80h: 14- 
subfunction 81h: 14- 
subfunction 82h: 14-- 
subfunction 83h: 14- 
subfunction 84h: 14- 
subfunction 85h: 14~ 
subfunction 86h: 11- 
subfunction 87h: 11- 
subfunction 8Ah: 11- 


NVEDUAMSHEHHDWWWHY 


N 





subfunction 00h: 14-6 


subfunction Oth: 14-7 
subfunction 02h: 14-7 
subfunction 03h: 14-7 
subfunction 04h: 14-8 
subfunction 05h: 14-8 
subfunction 08h: 14-8 
subfunction 09h: 14-9 
subfunction OAh: 14-9 
Multiplex function 19h 
subfunction 00h: 8-134 
subfunction OLh: 8-134 
subfunction 02h; 8-135 
subfunction 03h: 8-135 
subfunction 04h: 8-135 


Multip 
su 
su 
su 
su 
su 
su 


ex function LAh 


bfunction O1h: 8-98 
function 02h: 8-99 
bfunction 21h: 36-8 
function 3Ch: 36-9 
bfunction 3Eh: 36-9 
function 3Fh: 36-9 
bfunction 44h: 36-10 
bfunction 52h: 36-10 
bfunction 53h: 36-10 


S 


subfunction 72h: 36-10 


sul 





function 7Bh: 36-11 


subfunction 7Dh: 36-11 
subfunction ADh: 36-11 


Multiplex function 








Multiplex function 40h 
subfunction Oth: 8-146 
subfunction 02h: 8-146 

Multiplex function 43h 
subfunction 00h: 10-1 


subfunction 10h: 10- 
Multiplex function 46h 
subfunction 01h: 8-117 


sui 
sul 
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su 
Multip 
su 
su 
Multip! 
sul 
su 
su 


unction 02h: 8-117 
unction 53h; 34-11, 
2 
function 80h: 14-6 
x function 48h 
unction OOh: 8-117 
unction 10h: 8-117 
x function 4Ah 
unction Olh: 8-125 
‘unction 02h: 8-126 
function OSh: 8-118 


1 oS 


asocac 





Cos 


Multiplex function 4Bh 


su: 


bfunction O1h: 8-136 


subfunction 02h: 8-137 


su 








bfunction 03h: 8-139 


bfunction 00h: 8-98, 36-8 


Bh: 8-140 


subfunction 04h: 8-139 
subfunction 05h: 8-139 
Multiplex function 5453h 


sub: 
sub 
sul 
sul 
sul 
Sul 
sul 
sub 
sub! 


Sogg 


unction 00h: 36-69 
function 01h: 36-69 
unction 02h: 36-70 
‘unction 03h: 36-70 
function 04h: 36-70 
‘unction 05h: 36-71 
unction 10h: 36-72 
unction | fh: 36-72 
unction 12h: 36-72 


subfunction 13h: 36-72 
subfunction 14h: 36-73 


su. 
sub: 
sub: 
sub: 
D: 
0) 


g 


sui 
su 





function 5h: 36-73 
function 16h: 36-73 


unction 20h: 36-74 
function 21h: 36-74 
function 22h: 36-74 
function 23h: 36-74 


Multiplex function 55h; 8-102 

Multiplex function 62h: 34-14 
Subfunction 82h: 33-29 
Subfunction 84h: 33-29 

Multiplex function 7Ah 
subfunction 00h: 20-23 
subfunction 80h: 20-23 
subfunction 81h: 20-24 
subfunction 85h: 20-24 
subfunction FEh: 20-24 
subfunction FFh: 20-24 





Multiple 
Multiple 
Multiple: 





x function 7Fh:; 36-51 
x function 80h: 27-18 
x function 82h 


subfunction 00h: 36-53 
subfunction OLh: 36-53 
subfunction 02h: 36-53 
subfunction 10h: 36-53 


Multiple: 
sub: 
sub: 
sub 

Multiple: 
sub: 
sub: 
sul 
sul 

Multiple 

Multiple: 

Multiple: 

Multiple: 


DI 
DI 





x function 89h 
unction 00h: 36-77 
unction 01h: 36-77 
function 02h: 36-77 

x function 90h 
unction 00h: 36-52 
function 02h: 36-52 
unction 03h: 36-52 
unction 04h: 36-52 

x function 93h: 36-24 
x function Alh: 9-20 
x function AAh: 36-76 
x function ACh 





sub; 


‘unction 00h: 8-125 


Multiplex function ADh 


sub: 
sub: 


unction 00h; 8-103 
unction 01h; 8-103 


subfunction 02h: 8-103 


unction 03h: 8-103 


subfunction 04h: 8-103 


unction 10h: 8-103 
unction 40h: 8-146 
function 80h: 8-127 
unction 81h: 8-128 


subfunction 82h: 8-128 
subfunction 83h: 8-128 


Multiplex function AEh 


su 


0: 
subd: 


Multiplex function BOh 


sub: 
sub! 


unction 00h; 8-126 
unction 01h: 8-126 


‘unction 00h: 8-124 
unction Olh: 8-125 





Multiplex function B4h 


su 
sub: 
su 
sub! 





function 00h: 26-5 
unction OLh: 26-5 
unction 02h: 26-5 
function 03h: 26-6 


subfunction 04h: 26-6 





sub 
Multiple 


unction 05h: 26-6 
x function B7h 


subfunction 00h: 8-99 

subfunction 01h: 8-99 

subfunction 02h: 8-100 
subfunction 03h: 8-100 
subfunction 04h; 8-100 
subfunction 06h; 8-100 
subfunction 07h: 8-100 
subfunction 10h: 8-101 
subfunction 11h: 8-101 


Multiple: 





x function B8h 


subfunction 00h; 27-18 


sub 


unction 03h: 27-18 


subfunction 04h: 27-18 


sub! 
subi 
sub: 
Multiple. 
subi 
sub 
sub 


‘unction 08h: 27-19 
unction 09h: 21-13 
x function B9h 
function QOh: 19-21 
unction Oh: 19-21 
unction 03h; 19-21 


subfunction 04h: 19-21 
subfunction 05h; 19-22 
subfunction 06h; 19-22 


sub 
Multiple: 
sub 


Multiplex function BFh 


function O8h: 19-22 
x function BCh 
unction 06h; 8-124. 
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function O7h: 27-19" 
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subfunction 00h: 
subfunction Qlh: 
subfunction 80h: 


19-22 
19-23 
19-23 


Multiplex function COh 


subfunction 00h: 


20-25 


Multiplex function C9h 


subfunction 00h: 
subfunction 87h: 


Multiplex function CAh 


subfunction 00h: 
subfunction 01h: 
subfunction 02h: 
subfunction 03h: 
subfunction 04h: 


Multiplex function CBh 


subfunction 00h: 
subfunction O1h: 
subfunction 02h: 
subfunction 05h: 
subfunction 06h: 
subfunction 07h: 
subfunction 08h: 
subfunction 09h: 


subfunction OAh: 


subfunction 0B 
subfunction OCI 








subfunction 10h: 


subfunction 1 Lh: 29-8, 29-9 


subfunction 12h: 
subfunction 13h: 
subfunction 14h: 
subfunction 15h: 
subfunction 16h: 
subfunction 17h: 


subfunction ODh: 
subfunction QEh: 
subfunction OFh: 


34-14 
34-14 
34-1 
34- 
34- 
34- 
34. 


BWWWW 


29- 





29.’ 


29-9 

29-12 
29-12 
29-13 
29-13 
29-14 


Multiplex function CDh 


subfunction 00h: 
36-61 


30-1, 


subfunction 01h: 30-1, 
36-62 
subfunction 02h: 30-1, 
36-62 
subfunction 03h: 30-1, 
36-62 
subfunction 04h: 30-2, 
36-62 
subfunction 05h: 30-2, 
36-62 
subfunction 06h: 30-2, 
36-63 


subfunction 07! 
36-63 
subfunction 08: 
36-63 
subfunction 09) 
36-63 


h: 30-3, 
h: 30-3, 
h: 30-4, 


subfunction OAh: 30-4, 


36-63 
Multiplex function 

subfunction 00) 
subfunction 01 
subfunction 02! 
subfunction 03 
subfunction 04! 
subfunction 05) 


DOh 

h: 36-35 
h: 36-36 
+ 36-36 
h: 36-36 
h: 36-37 
h: 36-37 


Multiplex function Dih 


subfunction 00) 





: 36-38 


subfunction O1h: 36-38 
subfunction 02h: 36-39 
subfunction 03h: 36-40 
subfunction 04h: 36-41 
subfunction 10h; 36-42 
subfunction 11h; 36-42 
subfunction 12h: 36-42 
Multiplex function D2h 
subfunction 00h; 15-59 
subfunction 01h: 15-59, 





15-60 


Multiplex function D3h 
subfunction 00h: 28-7 
subfunction CBh: 28-3 


Multiplex function D4h: 36-1, 


36-2, 36-3 


Multiplex function D7h: 22-1 


Multiplex function DAh 
subfunction 55h: 36-75 

Multiplex function DCh 
subfunction 00h: 36-23 
subfunction 01h: 36-23 


subfunction 02 


h; 36-23 


Multiplex function DEh 


subfunction 00) 
subfunction 01 
15-55 

subfunction 02) 
subfunction 03 
subfunction 04! 
subfunction 05: 
8 


i=} 


subfunction 08 





subfunction 09! 





ns 
1: 


15-54 
15-54, 


215-55 
h: 
h: 
h: 
bfunction 06h: 
subfunction 07h: 
Phe 
h: 


15-55 
15-56 
15-56 
15-56 
15-57 
15-57 
15-57 


subfunction OAh: 15-57 


sul 
su 
su 
su 
Multip 
su 
su 
su 


bfunction OBh: 15-58 
bfunction OCh: 15-58 
bfunction ODh: 15-58 
bfunction OEh: 15-59 
ex function E3h 
bfunction 00h: 36-5 
bfunction 01h: 36-6 
bfunction 02h: 36-6 


subfunction 03h: 36-6 
subfunction 04h: 36-7 
subfunction 05h: 36-7 


sul 
s 
Multip 
su 
Multip 
Multip 
su 
su 


i=} 
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Multip 
su 
sul 


Multiplex Interrupt Usage: 1-13 
Multiplex interrupt: 8-98, 36-11 


bfunction 06h: 36-7 
bfunction 07h: 36-8 
lex function EDh 
bfunction 00h: 9-20 
lex function Flh: 9-21 
lex function FBh 
bfunction 42h: 11-1 
bfunction Alh: 9-21, 


ex function FFh 
bfunction 00h: 27-19 
bfunction 01h: 27-20 








Multiprocessor systems 


dispatching processors: 4-6 
processor availability: 4-7 


Multitaskers: 3-11, 36-66, 


36 


-67, 36-68 


Mufioz-Colman, Paul: 36-46 
MW386 


acknowledgements: 18-23, 


18 
bu 
bu: 


-25, 18-27 
ffer flushing: 18-30 
sy pointer: 18-26 


channel buffers: 18-20, 


18 


-21, 18-24, 18-25 


channel control: 18-20, 


18-21, 18-22, 18-23 
channel locking: 18-20, 
18-21, 18-22, 18-23 
channel status: [8-26 
channels: 18-27 

with data: 18-26 
communications ports: 
18-2, 18-3 
console mode: 18-38 
console port I/O: 18-38, 
18-39 
data transfer: 18-28 


MW386 


datagrams: 18-23, 18-24, 
18-25, 18-26, 18-27 

device names: 18-7 

device numbers: | 8-7 

disk buffers, flushing: 

18-39 

DOS tasks: 18-40, 18-41, 
18-42 


drives, attaching: 18-29 
error codes: 18-4 

error mode: 18-34 
events: 18-39 
FCB mode: 18-34 

file modes: 18-30 

group name; 18-44 

groups: 18-42, 18-43, 18-44 
hotkeys: 18-36 

T/O checking: 18-30 
installation check: 18-14 
interrupt vectors: 18-19 
invocation drive: 18-40 
machine number: 18-35 
messages, receiving: 18-29 
messages, sending: 18-28 
multitasking: 18-17 

packet sizes: 18-27 
password verification: 
18-36 

port information: 18-30 

port mode: 18-3 

port parameters: 18-3 

print job control; 18-4, 18-5 
print spooler control: 18-6, 
18-7, 18-10, 18-11, 18-12, 
18-13 

print spooler: 18-14 

printer mode: 18-10 

printer status: 18-13 

printer tab expansion: 18-11 
printer, current: 18-8, 18-9 
printing files: 18-8, 18-12 
privilege level: 18-35 
process number: 18-35, 18- 
40, 18-41 








switching tasks: 18-40 
task name; 18-41 

task suspension: 18-42 
tasks: 18-41 

terminal autobauding: 
18-32 

terminal configuration: 
18-33 

terminal drivers: 18-31, 
18-32 

terminal parameters: 18-32 
terminal port: 18-38 


MW386 


time slices: 18-42 

user login state: 18-36 
user name: 18-35 

user number; 18-8, 18-15, 
18-35 

user parameters: 18-16 
user status: 18-36 
users on system: 18-15 
version check: 18-29 
video adapter: 18-1 
video mode: 18-1 
video: [8-1, 18-2 


NCR: 5-73 
NDIS: 27-6 


binding modules: 27-7, 
27-8 

common characteristics 
table: 27-9 

initialization: 27-8 

MAC: 27-10 

NetBIOS: 27-10 
post-processing — interrupt: 
27-34 

Protocol Manager: 27-7 
PROTOCOL.INI: 27-8 
service-specific characteris- 
tics: 27-10 

service-specific status; 
27-10 

status codes: 27-7 

status: 27-8 

termination: 27-8 


NetWare 
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original INT 18h: 27-38 
resource information: 27-14 
sessions: 27-27 

status codes: 27-25 

status: 27-26 


NetBIOS requests: 27-13, 27-14 
NetWare: 20-1 


bindery: 20-16 
broadcast mode: 20-12 
broadcasting: 20-14, 20-16 
connection control: 20-15 
comnection information: 
20-15 
connections; 20-22 
copying files: 20-18, 20-23 
directory maintenance: 
20-14 


directory searching: 20-19 
directory tree depth: 20-19 
disk cache: 20-16 

drive flag table: 20-21 

drive flags: 20-21 

drive handle table: 20-21 
drive information: 20-18, 
20-21 

end-of-job call: 20-3, 20-10 
error mode: 20-12 

event service routine: 20-27 
fake roots: 20-19 

file attributes: 20-2, 20-17 
File Control Blocks: 20-4, 
20-5, 20-8, 20-17, 20-18 
file information: 20-15 

file locking: 20-6, 20-7, 
20-8, 20-9, 20-20, 20-21 
file servers: 20-16, 20-21, 
20-22 

group name: 20-15 
high-level language API: 
20-25 

internet address: 20-15 
IPX——see also IPX: 20-23, 
20-25 

local drives; 20-12 





resetting: 18-39 NDOS: 36-47 
restricted directories: 18-42, NDOSSTAK: 36-47 


18-43 NetBIOS: 14-5, 27-24 


login: 20-15, 20-16 
logout: 20-11 
low-level API: 20-25 


semaphores: 18-14, 18-15, 
18-33, 18-34, 18-36, 18-37 

service routines: 18-24, 18- 
25 

shared drives: 18-18 


command codes: 27-25 
installation check: 27-13 
name number: 27-19 
Network Control Block: 
27-25 


LSL.COM: 20-25 
network address: 20-21, 
20-26, 20-29 

network data transfer: 
20-27, 20-28 
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object types: 20-17 

objects: 20-15 

passwords: 20-15, 20-16 

PCOX: 20-25 

personal files: 20-7 

print spooler: 20-2, 20-13 

properties: 20-15 

record locking: 20-3, 20-4, 

20-5, 20-9, 20-10, 20-16 

releasing CPU: 20-29 

resource allocation: 20-11 

security levels: 20-17 

semaphores: 20-6, 20-10 

shell—see NetWare shell: 

20-23 

shell timer interrupt checks: 

20-12 

show-dots flag: 20-19 

sockets: 20-26 

SPX—see also SPX: 20-30 

system time: 20-18 

task mode byte: 20-1 

Transaction Tracking Sys- 

tem: 20-6 

transaction tracking: 20-6, 

20-16 

volume statistics: 20-11 
NetWare shell 

broadcast notification: 

20-24 

multiplexor: 20-23 

unknown functions: 20-23, 

20-24 

version check: 20-20 
NETWKSTA.EXE: 27-17 
Network 

data transfer; 20-27, 20-28, 

20-30, 20-32, 20-33 

direct disk I/O: 27-13 

idle: 27-16 

installation check: 27-13, 

27-18 

NetBIOS name number: 

27-19 

post handler: 27-18 

printer control: 27-13, 

27-14 

redirection list: 8-80, 8-81, 

8-82 

redirection: 8-81 

text header: 27-19 

unknown functions: 27-14, 

27-16, 27-19 


Network addresses: 20-21, 
20-26, 20-29, 27-30, 27-31, 
27-34 

Network devices: 8-145 

Network Driver Interface Speci- 
fication—-see NDIS: 27-6 

Network events: 27-18 

Network machine name: 8-58, 
8-78 

Network machine number: 8-72, 
8-76 

Network printer 
mode: 8-79, 8-80 
setup string: 8-79 

Network redirection mode: 8-80 

Network redirector interface: 
19-1 
canonical filenames; 19-13 
committing files: 19-4 
directories: 19-2, 19-3 
directory searching: 19-9, 
19-10 
disk buffers: 19-12 
disk space: 19-5 

ile attributes: 19-6 

ile locking: 19-5 

ile position: 19-12 

iles: 19-3, 19-4, 19-7, 19-8, 

19-9, 19-10, 19-15 

installation check: 19-2 

IOCTL: 19-14 

printer control; 19-11, 

9-13 

process termination: 19-12 

reading files: 19-4 

redirector control: 19-11 

unknown functions: 19-6, 

9-7, 19-8, 19-10, 19-14, 

9-15 
writing files: 19-4 

Network transport layer: 27-21 

NEWFONT: 5-55 

NewSpace: 6-38, 6-39 
debugging dump: 6-39 
disable driver: 6-38 
enable driver: 6-38 
installation check: 6-38 

NLSFUNC: 8-128 
code page: 8-129 
country-specific 
tion: 8-129, 8-130 
installation check: 8-128 








informa- 


NMI: 2-2 
Non-maskable interrupt: 2-2 
Non-volatile RAM: 4-1, 4-2 
EISA: 4-9, 4-10 
NorthNet Jetstream—see also 
Jetstream: 36-28 
Norton Utilities: 36-47 
Novell NACS—see 
NASI: 7-22 
Novell NASI/NACS: 20-25 
Novell NASI: 7-22 
control: 7-23 
input: 7-22 
installation check: 7-23 
output; 7-22 
status: 7-23 
Novell NetWare—see 
NetWare: 8-5, 8-24, 8-28, 
8-32, 20-1 
Novell, Inc.: 36-12 
NTNX 
acknowledgements: 18-23, 
18-25, 18-27 
buffer flushing: 18-30 
busy pointer: 18-26 
channel buffers: 18-20, 
18-21, 18-24, 18-25 
channel control: 18-20, 
18-21, 18-22, 18-23 
channel locking: 18-20, 
18-21, 18-22, 18-23 
channel status: 18-26 
channels with data: 18-26 
channels: 18-27 
data transfer: 18-28 
datagrams: 18-23, 18-24, 
18-25, 18-26, 18-27 
dedicated host: 18-19 
devices, attaching: 18-34, 
8-35, 18-37 
DOS intercept: 18-7 
drives, attaching: 18-29 
error codes: 18-4 
file locking: 18-33, 18-37 
‘ile modes: 18-30 
ags: 18-19 
graphics: 18-20 
host processor: 18-29 
/O checking: 18-30 
nDOS pointer: 18-5 
installation check; 18-14 
INT 28h entry point: 18-7 


Novell 





interrupt vectors: 18-18, 
18-19 
message display: 18-18 
messages, receiving: 18-29 
messages, sending: 18-28 
messages: 18-37 
MUD files: 18-19 
multitasking: 18-17, 18-19 
packet sizes: 18-27 
print job cancellation: 18-4, 
print job control: 18-5 
print spooler control: 18-6, 
8-7, 18-10, 18-11, 18-16 
printer driver: 18-8 
rinter drivers, user-written: 
18-5, 18-6 
printer mode: 18-10 
printer tab expansion: 18-11 
printer, current: 18-8, 18-9 
printing files: 18-8, 18-12 
rebooting: 18-39 
semaphore table: 18-31 
semaphores; 18-14, 18-15, 
18-36, 18-37 
serial port parameters: 18-9 
service routines: 18-24, 
18-25 
shared drives: 18-17, 18-18 
slave timers: 18-16 
system locking: 18-16 
terminal drivers: 18-31 
terminal output: 18-31 
timeouts: 18-18 
unknown functions: 18-14, 
18-44 
user number: 18-8, 18-15 
user parameters: 18-16 
users on system: 18-15 
version check: 18-29 
Nu-Mega Technologies: 36-55 
NUL: 8-29, 8-46, 8-47 
NumLock: 3-18, 3-20, 36-23 





Object Professional: 36-75 

Objects, network-accessible: 
8-144, 8-145 

Olivetti: 3-12 

OmniView—see also TopView: 
15-1 
device information tables: 
17-8 
entry point: 17-8 


exit notification: 17-9 
foreground/background: 
17-9 
installation notification: 
17-8 
process _creation/destruc- 
tion: 17-8 
task switching: 17-9 
OMTI 
drive data: 6-22 
Ontrack Computer Systems: 
6-17 
Open file limit: 8-14 
Open file list: 8-71 
Open file table; 8-14, 8-111 
Open Window menu: 15-8 
Opened FCB: 8-9, 8-12, 8-13, 
8-15 
Opening files: 8-5, 8-9, 8-24, 
8-25, 8-49, 8-91, 
8-113, 9-19, 29-4 
Operating system hooks 
BIOS tracing: 3-17 
device control: 3-7 
device usage: 3-10, 3-11 
keyboard intercept: 3-6 
keyboard: 3-8 
program termination; 3-7 
SysReq: 3-4 
SysRq key: 3-8 
Operating system indicator: 3-22 
OPTASM: 36-47 
OPTHELP.COM: 36-47 
Oracle SQL: 9-22 
OS/2: 3-3, 3-4, 5-64 
relocated IRQs: 2-11, 2-12, 
2-13, 2-14 
time slices: 14-4 
OS/2 compatibility box: 8-18, 
8-19, 8-21, 8-22, 8-33, 
8-35, 8-45, 8-46, 8-78, 
8-83, 8-96, 8-128, 8-133, 
8-146 
foreground/background 
switch: 8-146 
OS/286: 9-14 
calling real mode: 9-14, 
9-15, 9-16 
heap management: 9-16 
memory allocation: 9-17 
memory copy: 9-19 
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protected mode: 9-15 
segment creation: 9-16 
segment descriptors: 9-19 
segment modification: 9-17 
task gates: 9-15 

0S/386—see also OS/286: 9-14 
memory mapping: 9-18 
page locking: 9-18, 9-19 
page tables: 9-17, 9-18 
virtual memory manager: 
9-17, 9-18, 9-19 

Out of paper: 3-21 

Overflow: 2-2 

Overlay managers: 35-3 

Overlays: 8-40, 8-43, 35-3 


Packet driver specification: 
27-27 

Packet drivers: 27-27 
completion function: 27-31 
driver information: 27-27 
error codes: 27-28 
initialization: 27-29 
installation check; 27-27 
multicast list: 27-33 
network address: 27-30, 
27-34 
network interface types: 
27-28 
parameter table: 27-31 
parameters; 27-30 
post-processing interrupt: 
27-34 
receive mode: 27-32, 27-33 
resetting: 27-30 
statistics: 27-34 
termination: 27-29, 27-30 
transmitting data: 27-29, 
27-31 
version check: 27-27, 27-31 

Page faults: 9-11 

Page frame: 10-4, 10-6, 10-14 

Page locking: 11-22, 11-23 

Page mapping: 10-12 

Page tables: 9-4, 9-9, 9-10, 9-17, 
9-18 

Page-aligned: 11-5 

Paint Tools: 5-71 

Paintbrush: 5-39 

Palette locking: 5-19, 5-56, 5-57, 
5-58 
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Palette registers: 5-19, 5-20, 
5-22, 5-23, 5-27, 5-56 

Panel files: 15-13 

Paradise: 5-73 
emulation control: 5-11 
mode setting: 5-11 

Parallel port: 3-2, 3-6, 3-20, 
3-21, 8-3 

Parity error: 2-9 

Parsing filenames: 8-16 

Passwords: 8-81, 20-15, 20-16, 
21-1, 21-2, 21-3, 24-5, 25-4 
MDEBUG: 36-43, 36-44, 
36-45 
MW386; 18-36, 18-39 

Path separators: 8-105 

PC Cluster Disk Server: 27-38 

PC Cluster Program: 27-38 

PC Convertible: 3-13 
automatic power-up: 3-25 
external event wait: 3-5 
modem power: 3-6 
power off: 3-6 
system profiles: 3-5 
system resume vector: 3-27 
system status: 3-6 

PC LAN Program: 8-91 
installation check: 19-1 
REDIR: 19-1, 19-23 
REDIRIFS: 19-1, 19-22, 
19-23 
unknown functions: 19-1 

PC Magazine 
PCMANAGE/DCOMPRE 
S: 6-39 
PCSpool—see 
36-47 
PUSHDIR: 36-49 

PC Network 
installation check: 19-21 

PC Tools: 33-1 
BACKTALK—see BACK- 
TALK: 33-1 
DATAMON-~—see 
DATAMON: 33-29 
DATAMON; 33-4 
DESKTOP—see 
DESKTOP: 33-3 
installation check, sched- 
uler: 33-2 


PCSpool: 


PC-Cache—see PC-Cache 
and disk caches: 
33-4 
PCRUN—see PCRUN: 
33-19 
PCShell-—-see PCShell: 
33-17 
subfunction 9Ah: 33-3 
subfunction 9Eh: 33-3 
subfunction A lh: 33-3 
subfunction A2h: 33-3 
subfunction A3h: 33-4 
subfunction Adh: 33-4 
subfunction A5h: 33-4 
subfunction A6h: 33-4 
subfunction A7h: 33-5 
subfunction A8h: 33-5 
subfunction A9h: 33-5 
subfunction AAh: 33-5 
subfunction ABh: 33-5 
subfunction ACh: 33-6 
subfunction ADh: 33-6 
PC Tools 
subfunction AEh: 33-6 
subfunction AFh: 33-6 
subfunction BOh: 33-6 
subfunction B 1h: 33-7 
subfunction B2h: 33-7 
subfunction B3h: 33-7 
subfunction B4h: 33-7 
subfunction B5h: 33-7 
subfunction B6h: 33-8 
subfunction B7h: 33-8 
subfunction B8h: 33-8 
subfunction B9h: 33-9 
subfunction BAh: 33-9 
subfunction BBh: 33-9 
subfunction BCh: 33-9 
subfunction BDh: 33-10 
subfunction BEh: 33-10 
subfunction BFh: 33- 
subfunction COh: 33-1 
subfunction Ch: 33-1 
subfunction C2h: 33-1 
subfunction C3h: 33- 
subfunction C4h: 33- 
subfunction CSh: 33- 
subfunction C6h: 33- 
subfunction C7h: 33- 
subfunction C8h: 33-1 
subfunction C9h: 33-1 
subfunction CAh: 33-13 
subfunction CBh: 33-13 
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subfunction CCh: 33-13 
subfunction CDh: 33-13 
subfunction CEh: 33-14 
subfunction CFh: 33- 
subfunction DOh: 33- 
subfunction Dih: 33-1 
subfunction D2h: 33-1 
subfunction D3h: 33-1 
subfunction D4h: 33-1 
subfunction D5h: 33- 
subfunction D6h: 33- 
subfunction D7h: 33- 
subfunction D8h: 33- 
subfunction D9h: 33-16 
subfunction DAh: 33-16 
subfunction DBh: 33-17 
subfunction DCh: 33-17 
subfunction DDh: 33-17, 
33-18, 33-19 
PC Tools 
subfunction DEh: 33-20 
subfunction DFh: 33-20 
subfunction E0h: 33-20 
subfunction Elh: 33-20 
subfunction E2h: 33-21 
subfunction E3h: 33-21 
subfunction E4h: 33-21 
subfunction E5h: 33-21 
subfunction E6éh: 33-21 
subfunction E7h: 33-22 
subfunction E8h: 33-22 
subfunction E9h: 33-22 
subfunction EAh; 33-22 
subfunction EBh: 33-23 
subfunction ECh: 33-23 
subfunction EDh: 33-23 
subfunction EEh: 33-23 
subfunction EFh: 33-24 
subfunction FOh: 33-24 
subfunction Fih: 33-24 
subfunction F2h: 33-25 
subfunction F3h: 33-25 
subfunction F4h; 33-25 
subfunction F5h: 33-25 
subfunction Féh: 33-26 
subfunction F7h: 33-26 
subfunction F8h: 33-26 
subfunction F9h: 33-27 
subfunction FAh: 33-27 
subfunction FBh: 33-27 
subfunction FCh: 33-27 
subfunction FDh:; 33-28 
subfunction FEh: 33-28 
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subfunction FFh: 33-28 
unknown functions: 33-1, 
33-2, 33-3, 33-4, 33-5, 33- 
7, 33-9, 33-10, 33-11, 33- 
13, 33-15, 33-16, 33-18, 
33-19, 33-20, 33-21, 33-22, 
33-23, 33-25 
VDEFEND—see 
VDEFEND: 33-28 

PC-Cache: 33-4 
delayed writes: 6-34 
disable: 6-35 
enable: 6-35 
flush: 6-33, 6-34, 6-35 
get code segment: 6-32 
installation check: 6-34, 
6-35 
internal data: 6-34 
large-disk support: 6-33 
unknown. functions: 6-30, 
6-31, 6-33 

PC-IPC: 36-50 
command codes: 36-50 
error codes: 36-51 

PC-Net 
semaphores: 27-35 

PC/370: 36-51 

PC/TCP: 27-27, 27-34 

PC3270 
host buffer: 26-5 
initialization: 26-13 
installation check: 26-5, 
26-12 
internal functions: 26-12, 
26-13 
signature block: 26-12 
termination: 26-13 
unknown functions: 26-5, 
26-6, 26-13 

PcANY WHERE: 28-4 
configuration: 28-5, 28-6 
data transfer: 28-6 
error checking: 28-4 
installation check; 28-4, 
28-7 
keyboard control: 28-6 
logging off: 28-4 
screen control: 28-6 
screen updates: 28-4 
sessions: 28-5 
suspending: 28-5 

PCjr: 3-12 
cassette: 3-2, 3-3 


keyboard: 3-19, 3-26 
sound: 3-26 
PCMOUSE: 13-16 
PCOX API: 20-25 
PCRUN 
installation check: 33-19 
parameters: 33-19 
PCShell 
and PCRUN: 33-19 
flags: 33-19 
installation check: 33-17 
popping up: 33-17, 33-18 
PCSpool: 36-47 
control blocks: 36-47, 
36-48 
flushing queue: 36-48 
flushing writes: 36-48 
installation check: 36-49 
printer status: 36-49 
queue control: 36-49 
queue file: 36-49 
Periodic interrupt: 6-13 
Personal Calendar: 36-46 
Personics, Inc.: 5-55, 5-56, 5-57, 
5-58, 5-59 
Phar Lap: 9-1, 9-20, 9-21 
286-DOS/Extender: 9-20 
installation check: 9-20 
version check: 9-14 
virtual memory manager: 
9-8, 9-9, 9-10, 9-11, 9-12 
Phar Lap 386/DOS-extender: 
9-1 
configuration information: 
9-12 
debugging: 9-6 
DOS data buffer: 9-8 
executing programs: 9-13 
interrupt vectors: 9-2, 9-3, 
9-4 
interupt vectors: 9-2 
locking memory: 9-9 
memory allocation: 9-8 
memory errors: 9-8 
memory mapping: 9-3 
memory movement: 9-8 
memory statistics: 9-10 
memory usage: 9-11, 9-12 
page faults: 9-11 
page tables: 9-9, 9-10 
physical addresses: 9-3, 9-5 
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real mode, accessing: 9-2, 
9-3, 9-4, 9-5, 9-6 
real-mode memory: 9-12, 
9-13 
reset; 9-1 
segment aliasing: 9-7 
segment attributes: 9-8 
segment base: 9-3 
segment modification: 9-7 
swap space: 9-11 
virtual memory manager: 
9-8, 9-9, 9-10, 9-11, 9-12 
Phar Lap DOS Extender: 9-20 
Phillipot, Patrick: 36-75 
Phoenix 386 BIOS: 5-1 
Phoenix BIOS: 3-12, 3-13, 4-11, 
5-1 
CPU speed: 4-11 
PKTINT.COM 
buffers: 27-36 
enabling: 27-37 
entry point: 27-36 
initialization: 27-36 
removing packets: 27-37 
statistics: 27-37 
Plotters: 14-10 
Pointing device: 2-16 
Pointing device interface—see 
mouse: 3-14 
device handler: 3-16 
device type: 3-15 
enabling/disabling device: 
3-14 
initialization: 3-15 
resetting device: 3-14 
resolution: 3-15 
sampling rate: 3-14 
scaling factor: 3-16 
PORT network: 27-12 
Portfolio: 4-4 
POST: 3-5 
Post routines: 27-18 
Power conservation: 2-17, 4-5, 
4-6 
Power control 
PC Convertible: 3-6 
Power-off: 4-4 
Power-on self-test 
error log: 3-5 
Power-up 
automatic: 3-25 














\ 
| 
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Priam 
disk controller: 6-16 
disk partitioning: 6-16 
PRINT; 8-130, 8-146 
critical region flag: 8-130 
critical section: 27-16 
error check: 8-133 
freeze queue: 8-132 
installation check: 8-131 
remove file: 8-132 
restart queue: 8-133 
submit file: 8-131 
time slices: 8-131 
undocumented functions: 
8-130, 8-131 
Print screen: 3-1, 5-27, 31-4 
Print spooling: 36-15, 36-47 
Printer: 2-8 
and APL*Plus/PC: 31-5 
character output: 3-20 
initialization: 3-21 
and LANtastic: 21-7 
and network: 27-13, 27-14 
out of paper: 3-21 
output: 8-3 
and PCSpool: 36-47 
status: 3-21, 18-13, 36-49 
timeouts: 21-11, 21-12 
and VINES: 22-17 
Z100: 2-10 
Printer controllers: 30-1 
Printer redirection: 8-74, 8-75, 
8-79, 8-80, 8-81 
Printers: 2-5, 14-10 
Printing, and Jetstream: 36-29, 
36-30 
Printing files: 8-131, 8-132 
Process identifier: 8-45, 8-58, 
8-70, 8-71, 8-83, 8-92 
Process identifiers: 17-3 
Processor exceptions: 11-10 
Processor faults 
alignment check: 2-8 
breakpoint; 2-2 
coprocessor error: 2-8 
coprocessor missing: 2-3 
coprocessor protection 
error: 2-3 
debugging: 2-1 
divide error: 2-1 
double fault: 2-3 


general protection viola- 
tion: 2-6 
invalid opcode: 2-3 
invalid TSS; 2-4 
overflow: 2-2 
page fault: 2-7 
range error: 2-2 
reserved; 2-4 
segment not present: 2-5 
single-step: 2-1 
stack fault: 2-6 
Processor mode: 11-1 
switching: 3-10, 10-20, 
11-16 
Profilers: 36-64 
Program Segment Prefix: 8-14 
Program termination: 3-7, 8-1, 
8-43, 8-67, 8-92 
Program termination type: 8-43 
Programmable Option Select: 
3-17, 6-16 
Progressive Solutions: 17-1 
Protected mode: 10-20 
Protected mode, switching to: 
3-10, 9-22 
PROTMANS; 27-6 
Protocol Manager: 27-6 
PrtSe; 17-11 
PSP: 8-14, 8-43, 8-92, 33-4 
child: 8-64 
PSP address: 8-45, 8-47, 8-51, 
8-52, 8-53, 8-62, 8-64, 8-83 
PUSHDIR.COM: 36-49 
installation check: 36-49 


Q-PRO4: 36-52 
Qcache 
buffer size: 6-29 
delayed writes: 6-29 
disable: 6-28 
dismount: 6-28 
enable: 6-28 
flushing: 6-28, 6-29, 6-30 
installation check: 6-29 
read: 6-29 
sectors: 6-28 
status: 6-30 
QEMM-386: 15-1 
high RAM: 15-60 
installation check: 15-60 
QPC Software: 27-36 


QRAM 
high RAM: 15-60 
installation check: 15-60 

Quarterdeck Office Systems: 
15-1, 15-59 
MANIFEST: 15-59 
QEMM-386: 15-60 
QRAM: 15-60 
VIDRAM: 15-60 


RAID: 36-52 
address: 36-52 
installation check; 36-52 
uninstall; 36-52 
RAM cache: 4-8 
RAM disk: 4-2 
RAM refresh: 2-7 
Ratcliff, John W.: 36-24 
Rational Systems: 9-1, 9-21 
Raw disk I/O; 8-94, 8-95 
Raw mode: 8-29 
Reading files: 8-12, 8-26, 8-114 
Real-time clock: 2-16, 3-8, 3-12, 
3-23, 3-24, 8-16, 8-17, 8-98 
alarm: 3-24, 3-25, 3-27, 4-1 
automatic power-up: 3-25 
Rebooting: 3-21, 4-12, 7-14 
RECEIVER.COM 
entry point: 19-21 
files: 19-22 
keyboard handler: 19-22 
network events: 19-21 
Record locking: 8-69 
Red E Products, Inc,: 36-54 
Redirected printer 
mode: 8-79, 8-80 
Redirection 
printer: 8-74, 8-75 
video: 5-45 
REDIRIFS: 8-54 
entry point: 19-23 
installation checks: 19-22 
unknown functions: 19-23 
Register Interface Library: 5-63 
default register values: 
5-62, 5-63 
installation check: 5-63 
reading EGA registers: 
5-60, 5-61, 5-62 
writing EGA registers: 
5-61, 5-62 








RELEASE: 36-76 

Remote control software: 28-1 
Carbon Copy: 28-1 
COMMUTE: 28-1 
pcANY WHERE: 28-4 
TeleReplica: 28-7 

Remote devices: 8-32 

Remote files: 8-7, 8-14, 8-32, 
8-52, 8-53, 8-70, 8-144 

Removable media: 8-54, 8-121 

Renaming directories: 8-10 

Renaming files: 8-9, 8-64 

Resetting disks: 8-5 

RESPLAY: 36-53 
initialization: 36-53 
installation check: 36-53 
playback: 36-53 
sampling: 36-53 
uninstalls: 36-53 

Return codes—see status codes, 
error codes: 25-7 
APPC/PC: 25-3, 25-7, 
25-10 

Right-Hand Man: 36-54 

Roland MPU: 2-5 

ROM BIOS: 3-1 
equipment list; 3-1 
memory size: 3-2 
tracing: 3-17 

Root directory: 8-12, 8-19 

Rose, Herb; 17-1, 17-13 

Runtime support: 35-1 

Russell, Stuart: 36-76 


Sangoma, X.25 interface: 27-38 
Sangoma CCPOP 3270: 26-6, 
26-7 
CCIP interface: 26-6 
SBEM driver—see SoundBlas- 
ter: 36-55 
Scan codes: 3-7, 3-17, 3-18, 
3-19, 3-20 
translation: 3-6, 3-26 
Schemmer, Bernd: 36-35 
SCHOOLMATE Plus: 36-68 
Screen blanking: 4-4, 4-5, 4-6, 
5-29, 5-45, 5-54, 5-71 
SCRNSAV2,COM 
installation check: 5-71 
Scrolling: 5-68 


Sperry PC; 5-32 
state: 5-43 
status: 5-55 
superimposing images: 5-32 
Tandy: 5-48, 5-50, 5-51 
Tatung: 5-29 
Taxan: 5-29 
Tseng: 5-23 
UltraVision: 5-55, 5-56, 
5-57, 5-58, 5-59 
underlining: 5-58, 5-59 
VEGA: 5-46, 5-47, 5-48 
vertical resolution: 5-27 
VESA SuperVGA BIOS: 
5-41 
VGA: 5-27, 5-28, 5-32, 
5-33, 5-35 
Video 7: 5-46, 5-47, 5-48 
video addressing: 5-28 
Video FOSSIL: 5-64, 5-70 
video state: 5-33, 5-35 
windowing: 5-18, 5-24, 
5-51, 5-52 
write pixel: 5-37 
ScrollLock: 3-18, 3-20 
SCROLOCK: 36-54 
enabling: 36-54 
installation check: 36-54 
SCSI 
Common Access Method: 
6-17, 6-18, 6-22 
controller addressing: 6-23, 
6-24 
controller commands: 6-25, 
6-26, 6-27 
controller info: 6-15 
data transfers: 6-26, 6-27 
diagnostics: 6-25 
disk information block: 
6-15 
get info: 6-14 
get parameters: 6-13, 6-14 
IBM: 6-18 
initialization: 6-13 
parking: 6-12 
resetting bus: 6-25 
TARGA.DEV: 6-23, 6-24, 
6-25, 6-26, 6-27 
TMC-870: 6-12, 6-15 
SCSI Interface Module: 6-18 
SCSI Read Capacity command: 
6-13, 6-14 
SD.COM: 36-54 
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SDA: 8-71, 8-75 
Seal, John J.: 5-18, 5-24, 5-26 
Seaware: 36-18 
Sector translation: 6-15 
Segment aliasing: 9-7, 9-16, 
11-6 
Segment base: 9-3, 9-17, 11-4, 
11-5 
Segment descriptors: 9-19, 11-3, 
11-4, 11-6, 11-7, 11-8 
access rights: [1-5 
Segment limit: 9-17, 11-3, 11-5 
Segment not present fault: 2-5 
Segment wrap: 2-6, 8-12, 8-13, 
8-15 
Semaphores: 16-5, 16-8, 16-12, 
16-13, 17-13, 17-14, 18-14, 
18-15, 18-31, 18-33, 18-34, 
18-36, 18-37, 20-6, 22-2, 
23-6, 27-32, 27-35 
Serial 1/O—see also serial port: 
7-1, 7-4 
communications interrupt: 
2-6 
input: 7-22 
mouse; 13-15 
output; 7-22 
third-party: 7-4 
Serial numbers 
disk: 8-35, 8-36, 8-89, 8-90, 
8-123 
OS: 8-143 
user: 8-18 
Serial port 
BIOS functions: 7-1 
break: 7-5, 7-9, 7-15, 7-19 
initialization: 7-1, 7-3, 7-4, 
7-10, 16-1, 16-2 
input: 7-2, 7-4, 7-8, 7-10, 
7-15, 7-19, 7-20, 8-2, 16-1, 
16-3 
modem signals: 7-19 
output: 7-1, 7-4, 7-9, 7-12, 
7-15, 8-2, 16-1, 16-3 
parameters: 7-2, 18-9 
set parameters: 7-3, 7-7, 7-9 
status: 7-2, 7-5, 7-7, 16-2, 
16-3, 16-4 
third-party functions: 7-4 
Server function call: 8-69 
SETVER: 8-18, 8-20 


i 
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Shamrock EMAIL 
communications 
ters: 27-1 
downloads: 27-3 
function 00h: 2 
function Oth: 2 
function 02h: 2 
function 03h: 2 
function 04h: 2 
function 05h: 2 
function 06h: 27- 
status: 27-1 
time limits: 27-1 
user function: 27-2, 27-3 
username: 27-1 

Shamrock NET.24 
acknowledgement: 27-4 
API enabling/disabling: 
27-3 
function 00h: 27-3 
function Olh: 27-4 
function 02h: 27-4 
function 03h: 27-4 
function 04h: 27-4 
function 05h: 27-4 
function 06h: 27-5 
function 07h: 27-5 
function 08h: 27-5 
function 09h: 27-5 
function OAh: 27-6 
function OBh: 27-6 
function O0Ch: 27-6 
read: 27-4, 27-5 
status: 27-3, 27-4 
transmission buffer: 27-4 
write: 27-4, 27-5, 27-6 

Shamrock Software: 27-1 


parame- 


7-1 
7-1 
T~1 
7-2 
7-2 
7-3 
3 


EMAIL—see Shamrock 
EMAIL 
NET.24—see Shamrock 
NET.24 


SHARE hooks: 8-49 

SHARE: 8-7, 8-26, 8-27, 8-52, 
8-53, 8-69, 8-70, 8-71, 8- 
133, 27-15 
file sharing modes: 8-25 
installation check: 8-133 
lock record: 8-51 
open file list: 8-50, 8-71 
retries: 8-32 
sharing record: 8-51 
undocumented functions: 
8-134 


Shared memory: 11-29, 11-30 
SHELLB: 8-134 
COMMAND.COM _ inter- 
face: 8-135 
installation check: 8-134 
internal interface: 8-135 
SHELLC: 8-134 
Shift keys: 3-18, 3-20 
Sierra SC1148x: 5-23 
Single-step interrupt: 2-1 
Sisco, Douglas: 36-58 
Skulason, Fridrik: 34-11, 34-12, 
34-13 
SLR Systems: 36-47 
SMARTDRV.SYS: 6-36, 6-37 
Soft-ICE: 36-55 
SoftCraft: 36-12 
Softlogic Solutions, Inc.: 17-1 
Sound: 15-4, 31-5 
Extended Batch Language: 
36-18 
FAKEY: 36-22 
sampling: 36-53 
and SoundBlaster: 36-57 
The IBM Digitized Sound 
Package: 36-24 
Sound generator: 3-26 
Sound multiplexor: 3-26 
SOUND,COM: 36-3 
active voice: 36-5 
interface: 36-3 
mode; 36-5 
reset: 36-4 
state: 36-4 
SoundBlaster: 36-55 
clock rate: 36-56 
instrument table: 36-56 
music status byte: 36-55 
playing music: 36-57 
resetting: 36-57 
system-exclusive com- 
mands: 36-58 
transposing music: 36-56 
version check: 36-55 
SPEECH.COM: 36-58 
SPEEDSCR.COM: 36-59 
installation check: 36-59 
Sperry PC: 3-13 
video: 5-32 
SPX 
data transfer: 20-32, 20-33 


installation check: 20-30 
network connections: 
20-30, 20-31, 20-32 
status; 20-32 
SQL Base: 36-59 
database engine: 36-59 
function numbers: 36-59 
version check; 36-61 
SQL Server: 36-61 
Stacker: 6-38, 6-40 
STACKS=: 8-48 
Standard input: 8-2, 8-3, 8-4, 8-5 
status: 8-4 
Standard output: 8-2, 8-3, 8-4 
Standby mode: 4-5 
Standby power: 3-6 
Stanislav, G. Adam: 36-8 
STARLITE architecture: 8-33, 
8-145 
network; 8-144, 8-145 
Status codes 
10Net: 23-1 
Btrieve: 36-13 
Common Access Method: 
6-22 
disk I/O: 6-2 
NetBIOS: 27-25 
Network Driver Interface 
Specification: 27-7 
Stay-Res Plus: 36-45 
program name: 36-46 
uninstall: 36-46 
installation check: 36-46 
Stdaux: 8-2 
Stdin: 8-2, 8-3, 8-4, 8-5 
status: 8-4 
Stdout: 8-2, 8-3, 8-4, 8-105 
Stdprn: 8-3 
Steiner, David: 36-22 
Stetson, John F.: 36-54 
Stokes, Kevin: 36-24 
STSC APL*Plus/PC—see 
APL*Plhus/PC: 31-1 
STSC, Inc: 31-1 
Stump, Sandi and Shane: 17-1 
Subdirectories 
changing: 8-24 
creation: 8-23, 19-2, 19-3 
removal: 8-24, 19-2 
SUBST: 8-53, 8-83 
Sunny Hill Software: 15-1, 17-1 
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Super PC-Kwik—see PC-Cache: 
6-30, 6-33 
SuperBIOS, Victor 9000: 4-12 
SuperVGA: 5-41 
Surface analysis: 6-13 
SWAP utilities: 36-61 
Swappable data area: 8-71, 8-75 
SWBIOS: 6-17 
get parameters: 6-17 
installation check: 6-17 
SWELL: 36-61 
"Borland support": 36-63 
installation check: 36-61 
status: 36-63 
suspending: 36-62 
uninstall: 36-63 
verbose mode: 36-62 
Switch character: 8-21 
Switchar: 8-21 
Sybase DBLIBRARY: 36-61 
Symantec: 36-47 
SYNC call: 8-5 
SYS_PROF: 36-64 
profiling results: 36-64 
profiling: 36-64 
resetting: 36-64 
status: 36-64 
SysRq key: 3-4, 3-8, 3-20 
System configuration: 3-11 
System date: 3-25, 3-26, 8-16, 
8-107, 8-110, 21-11 
real-time clock: 2-16, 3-24 
year: 8-110 
System Enhancement Associ- 
ates: 36-21, 36-35, 36-54 
System File Tables: 8-46, 8-109 
System profiles: 3-5 
System resume vector: 3-27 
System status; 3-6 
System time: 3-23, 8-17, 8-107, 
9-19, 20-18, 21-11 
real-time clock: 2-16, 3-23, 
3-24 
timer tick: 3-26 
System timer: 2-3, 3-26 
SYSVARS: 8-45 


TAME: 36-65 
installation check: 36-65 


multitaskers: 36-66, 36-67, 
36-68 
Tandy 
hard disk: 2-5 
INCRAM: 5-50 
model 2000: 5-48, 5-50, 
5-51 
RAM refresh: 2-7 
SCHOOLMATE Plus: 
36-68 
scrolling: 5-51 
video addressing: 5-48 
Tanenbaum, Andrew: 36-46 
Tangram Arbiter: 26-6 
TARGA.DEV 
controller addressing: 6-23, 
6-24 
controller commands: 6-25, 
6-26, 6-27 
data transfers: 6-26, 6-27 
diagnostics: 6-25 
early return mode: 6-24 
Task state segment: 2-4 
Task switcher 
entry point: 8-137 
instance data: 8-139 
switcher ID: 8-139 
Task switchers: 8-135 
DOS: 8-136, 8-137, 8-139 
notification function: 8-136 
Task switching: 17-12, 17-18 
Task View—see OmniView: 
15-1 
TASM: LI-1 
Tatung 
enhanced features: 5-29 
Taxan 
enhanced features: 5-29 
TBSCANX 
installation check; 34-13 
scanning for viruses: 34-13, 
34-14 
state: 34-13 
status; 34-13 
TCP/IP: 27-34 
TeleReplica: 28-7 
installation check: 28-7 
Teletype output: 5-17 
Terminate and stay resident: 
8-18, 8-43, 8-96, 11-28 
TES: 7-20 


I4q 


command interpreter: 7-22 
installation check: 7-20 
servers; 7-21 
session creation: 7-21 
sessions: 7-20, 7-21, 7-22 
status array: 7-21 
status: 7-20 
TesSeRact: 36-69 
background functions: 
36-74 
critical error handler: 36-70 
enabling TSRs; 36-72 
hotkeys: 36-70, 36-71 
InDOS flag: 36-73 
installation check: 36-69 
internal data: 36-70 
keyboard stuffing: 36-74 
popping up: 36-74 
reserved functions: 36-71, 
36-73, 36-75 
restarting TSR: 36-72 
status: 36-73 
uninstall; 36-72 
user parameters: 36-69 
user procedure: 36-74 
Texas Instruments Professional 
PC: 6-4 
video: 4-12 
Texas Instruments: 4-12 
The IBM Digitized Sound Pack- 
age: 36-24 
The Last Byte: 36-30 
high memory: 36-30 
The Software Bottling Com- 
pany: 36-22, 36-59 
THELP.COM: 36-69 
ThesPlus: 36-46 
Thomas, David G.; 36-65 
Thomson, Douglas: 28-7 
Threads: 16-6, 17-14 
ThunderByte 
disinfecting: 34-14 
installation check: 34-14 
TIL Xpert AIM; 27-20 
Time slices: 8-131, 15-2, 16-4, 
16-7, 17-13, 17-17, 17-18, 
18-42 
Microsoft Windows: 14-4 
Time: 8-17 
Timeouts 
external event wait: 3-5 
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system inactivity: 4-5, 4-6 
wait periods: 3-8, 3-9 
watchdog timers: 3-16 

Timer tick: 3-26 

Timestamp: 8-26, 8-50, 8-51, 
8-52, 8-53, 8-65, 8-107, 
8-143 

TKERNEL: 9-21 
entry point: 9-21 
installation check: 9-21 
uninstall; 9-22 

TLINK: 8-41, 35-3 

TOPS: 27-27 

TopSPEED Modula-2: 35-4 
procedure entry: 35-4 
procedure exit: 35-4 

TopView: 15-1, 15-10 
applying panels: 15-15 
asynchronous notification: 
15-26, 15-27 
background operation: 
15-26 
critical sections: 15-4, 15-5 
cursor position: 15-18, 15- 
19, 15-20, 15-24, 15-38 
disabling window manipu- 
lation: 15-26 
display, updating: 15-40, 
15-1, 15-7, 15-21 
error window: 15-5 
event notification: 15-26 
exclusive access: 15-42 
field mode: 15-15, 15-16, 
15-33, 15-36, 15-38, 15-41 
field table: 15-15, 15-16, 
15-21, 15-22, 15-23, 15-25, 
15-33, 15-42, 15-51 
help: 15-28 
input from objects: 15-14 
installation check: 15-6 
interrupt handlers: 15-3 
keyboard attributes: 15-33 
keyboard filters: 15-41 
keyboard: 15-16, 15-38 
locking: 15-42 
logical attributes: 15-21, 
15-24 
mailbox name: 15-39 
mailboxes: 15-12, 15-27, 
15-31, 15-33, 15-38, 15-39, 
15-42 
main menu: 15-29 


manager stream: 15-25, 
15-47 

memory allocation: 15-2 
and mouse: 15-28 

object attributes: 15-32, 
15-34 

object creation: 15-11 
object destruction: 15-12 
object EOF status: 15-38 
object handles; 15-3, 15-10 
object input: 15-14, 15-16, 
15-40 

object logical sizes: 15-30 
object output: 15-16, 15-17 
object status: 15-37 
OBJECTQ: 15-34, 15-38 
objects, closing: 15-36 
objects, erasing: 15-36 
objects, opening: 15-35 
orphaned windows: 15-27, 
15-28, 15-29 

panel files: 15-13 

panels: 15-15, 15-37 
permitting window manipu- 
lation: 15-25 

pointer: 15-38 

pointer attributes: 15-32 
pointer icon: 15-41 

pointer position: 15-27 
pointer scaling: 15-39, 
15-40 

private stack: 15-4, 15-7 
process control: 15-26, 
15-27 

query stream: 15-24 
reading screen contents: 
15-14 

Scissors menu: 15-26, 
15-28 

scrolling: 15-21, 15-25, 
15-27 

semaphores; 15-42 

shared programs: 15-8 
sound: 15-4 

system memory: 15-2, 15-8, 
15-11, 15-32, 15-46, 15-47 
task control: 15-5, 15-6 
time slices: 15-2 

timers: 15-15, 15-30, 15-38 
user streams: 15-27, 15-41 
version check: 15-6 

video: 15-1 

video mode; 15-28 


video output: 15-2, 15-17, 
15-31, 15-33 
virtual screen information: 
15-7 
visibility of window: 15-20 
window frame: 15-20, 
15-21, 15-22, 15-24, 15-25 
window movement; 15-27 
window name: 15-22, 
15-25 
window position: 15-6, 
15-18, 15-19, 15-20, 15-24 
window size: 15-18, 15-19, 
15-20, 15-24, 15-26, 15-27 
window streams: 15-17 
window width: 15-30 
windows, visibility of: 15-4 
TopView calls 
BEGINC: 15-4 
DISPEROR: 15-5 
ENDC: 15-5, 15-51 
FREEBIT: 15-3 
GETBIT: 15-3 
GETBUF: 15-7 
GETMEM: 15-2 
GETVER: 15-6 
ISOBJ: 15-3 
LOCATE: 15-4 
OSTACK; 15-4 
PAUSE: 15-2 
PGMINT: 15-6 
POSWIN: 15-6 
PRINTC: 15-2 
PUTMEM: 15-2 
SETBIT: 15-3 
SOUND: 15-4 
START: 15-5 
STOP; [5-5 
USTACK: 15-7 
TopView function 10h 
subfunction 00h: 15-2 
subfunction Oh: 15-2 
subfunction 02h: 15-2 
subfunction 03h: 15-2 
subfunction 13h: 15-3 
subfunction 14h: 15-3 
subfunction 15h: 15-3 
subfunction 16h: 15-3 
subfunction 18h: 15-4 
subfunction 19h: 15-4 
subfunction 1Ah: 15-4 
subfunction 1Bh: 15-4 
subfunction 1Ch: 15-5 











subfunction 1 Dh: 15-5 
subfunction 1Eh: 15-5 
subfunction 1Fh: 15-5 
subfunction 21h: 15-6 
subfunction 22h: 15-6 
subfunction 23h: 15-6 
subfunction 24h: 15-7 
subfunction 25h: 15-7 


pa 

wa 
7 

Oo 


TopView function 11h: 

TopView function 12h 
subfunction 00h: 15-10 
subfunction Olh: 15 
subfunction 02h: 15-1 
subfunction 03h: 15 
15-13 
subfunction 04h: 15-14, 
15-15 
subfunction O5h: 15-16, 
15-17 
subfunction 08h: 15-30 
subfunction 09h: 15-30 
subfunction OAh: 15-31, 
15-32 
subfunction OBh: 15-33, 
15-34 
subfunction OCh: 15-35 
subfunction ODh: 15-36 
subfunction 0Eh; 15-36 
subfunction OFh: 15-37 
subfunction 10h: 15-38 
subfunction 11h: 15-38, 
15-39 : 
subfunction 12h: 15-40 
subfunction 13h: 15-40, 
15-41 
subfunction 14h: 15-41, 
15-42 

TopView messages 
ADDR: 15-12 

DDTO: 15-31, 15-32 

PPLY: 15-15 

T: 15-38 

LOSE: 15-36 

IR; 15-13 

OF; 15-38 

IRASE: 15-36 

REE: 15-12 

ETSCALE; 15-40 

ANDLE: 15-10 

EN: 15-30 

OCK: 15-42 

EW: 15-11 

PEN: 15-35 














GOrrr 


call wee 2) Bes Bes Bes) 





OZ 


READ: 15-14, 15-15 
READN: 15-40 
REDRAW: 15-40 
SETESC: 15-41 
SETICON: 15-41 
SETNAME: 15-39 
SETSCALE: 15-39 
SIZEOF: 15-30 
STATUS: 15-37 
SUBFROM: 15-33, 15-34 
WRITE: 15-16, 15-17 
Topware Network Operating 
System: 27-12 
installation check! 27-19 
unknown functions: 27-35 
version check; 27-20 
Toshiba: 3-13 
Tracing calls: 3-17 
Transaction Tracking System: 
20-6 
TRAP.COM: 36-75 
installation check: 36-75 
Truncating files: 8-9, 8-15, 8-24, 
8-27 
TSCANX 
state: 34-13 
Tseng 
Digital/Analog Converter: 
5-23 
mode setting: 5-23 
TSR: 11-28 
TSRs 
AUTOPARK: 6-11 
TSS: 2-4 
Turbo Assembler: 11-1 
Turbo Pascal: 36-75 
Turbo Professional: 36-75 
TurboPower Software: 36-75, 
36-76 
TurboPower TSRs: 36-75 
data block: 36-76 
installation check: 36-75, 
36-76 
Typeahead: 8-5 
Typematic: 3-18 





UART; 4-2 

UltraVision: 5-12, 5-19, 5-20, 
5-21, 5-26 
character fonts: 5-59 
cursor: 5-58 
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extensions: 5-55 
font names: 5-57 
palette: 5-56, 5-57 
status: 5-55 
underlining: 5-58, 5-59 
video modes: 5-57, 5-59 
UMBs: 8-66, 10-3, 36-30 
Undocumented data structures 
code page structure: 8-129 
current directory structure: 
8-53 
disk buffer hash chain: 8-56 
disk buffer info: 8-56 
disk buffers: 8-55, 8-57 
DOS data segment subseg- 
ment control block: 8-48 
DOS parameter list: 8-70 
File Control Block: 8-6 
file sharing record: 8-51 
filename terminator table: 
8-87 
IFS driver list: 8-57 
IFS open file structure: 8-62 
IFS request block: 8-59 
list of lists: 8-46 
memory control block: 8-47 
SHARE hooks: 8-49 
SHARE lock record: 8-51 
special program names: 
STACKS code segment: 
8-48 
STACKS data segment: 
8-48 
swappable data area list: 
8-76 
swappable data area: 8-72, 
8-76 
system file tables: 8-51, 
8-52, 8-53 
Undocumented DOS: 36-27 
Undocumented functions 
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8-134, 8-135, 8-140, 
19-2, 19-3, 19-4, 19-5, 
19-6, 19-7, 19-8, 19-9, 
19-10, 19-11, 19-12, 
19-13, 19-14, 19-15, 


conventional memory: 
10-18 

CPU registers: 10-19 
entry point: 10-17 
installation check: 10-17 


VINES: 22-22 

Virtual DMA Specification: 
12-1 

WinOldAp: 14-6 

ZIPKEY: 32-1 


19-16 
PRINT: 8-130, 8-131 
ROM BIOS: 3-17 
SHARE: 8-134 
VGA: 5-22 


Ungermann-Bass Net One-—see 


Novell NASI 
Uninstall 
BACKTALK: 33-1 
CAS: 29-13 
DBOS: 9-23 
DECnet DOS CTERM: 
24-4 
DeskConnect: 28-4 
DESKTOP, PC Tools: 
33-17, 33-25 
F-DLOCK: 34-11 
F-LOCK: 34-12 
F-POPUP: 34-12 
F-XCHK: 34-12 
Logitech mouse: 13-14 
RAID: 36-52 
RESPLAY: 36-53 
SHELL2E: 36-1 
Stay-Res: 36-46 
SWELL: 36-63 
TesSeRact: 36-72 
TKERNEL: 9-22 
VDEFEND, PC Tools: 
33-29 
Video FOSSIL: 5-70 
WHOA!: 36-77 
University of Salford: 9-22 
Unlink: 8-27 
Unopened FCB: 8-5, 8-7, 8-8, 
8-9, 8-13, 8-16, 8-50 
Upper Memory Blocks: 8-47, 
8-66, 10-3 
User interface: 4-4 
User Interrupt usage: 1-15 
Usernames 
10Net: 23-7 
VINES: 22-18 


V86 mode: 11-17 
VCPI 


IRQ mapping: 10-19 
memory allocation: 10-18 


Vertical retrace: 2-5 
VESA 


memory size: 10-17 
mode switching: 10-20 
VDEFEND: 33-28, 34-14 
API: 33-29 
installation check: 33-29 
uninstall: 33-29 
VDS—see Virtual DMA: 12-1 
VDU: 4-2, 4-3 
VEGA VGA 
autoswitching: 5-48 
get display information: 
5-46 
get info: 5-48 
installation check: 5-46 
mode setting: 5-47 
Vendor-specific 
Texas Instruments: 6-4 
Western Digital: 6-4 
Verifying disk writes: 6-3, 8-17, 
8-64 
Version checks 
Alloy products: 18-29 
Amstrad PC1512: 4-3 


display positioning: 5-44 
get info: 5-41 

mode setting: 5-42 

scan line length: 5-44 
video memory access: 5-43 
video modes: 5-41, 5-42 
video state: 5-43 


VGA 


color setting: 5-27 
cursor emulation: 5-28 
display combination codes: 
5-32 

gray-scaling: 5-23, 5-28 
multiple displays: 5-28 
palette registers: 5-27 
PEL mask: 5-22 
undocumented functions: 
5-22 

vertical resolution; 5-27 
vertical retrace: 2-5 
video addressing: 5-28 
video blanking: 5-29 
video state: 5-33, 5-35 


APPEND: 8-100, 8-101 
CAS: 29-6 

DESQview: 15-53 

DOS: 8-18, 8-20, 8-116 
DPMI: 11-16 

EGA.SYS: 8-124 

EMS: 10-7 

Image Processing Interface: 
30-1 

LANtastic: 21-13 

Logitech Mouse: 13-15 
mouse: 13-11, 13-12 
MSCDEX: 19-19 

NetWare shell: 20-20 
packet drivers: 27-27, 

27-31 

Phar Lap 386/DOS-Ex- 
tender: 9-14 

SoundBlaster: 36-55 

SQL Base: 36-61 

TopView: 15-6 

Topware Network Operat- 
ing System: 27-20 


Victor: 4-12 
Victor 9000 SuperBIOS: 4-12 
VIDCLOCK.COM: 36-76 
installation check: 36-76 
Video: 5-1 
active page: 5-37 
ANSI control sequences: 
5-66 
and APL*Plus/PC: 31-6 
AT&T: 5-11 
ATI: 5-29, 5-45, 5-72 
autoswitching: 5-48 
blanking: 4-4, 4-5, 4-6, 
5-29, 5-45, 5-54, 5-71 
blinking: 5-15, 5-20 
border color: 4-3 
character attribute: 5-15 


character fonts: 5-26, 5-59, 


5-71, 5-72 


character generation: 5-24, 


5-25 
clearing display: 5-37 





| 
t 





color plane registers: 4-2, 
4-3 

color planes: 14-8 

color register paging: 5-22 
color setting: 5-16, 5-19, 
5-20, 5-21, 5-23, 5-27 
color: 5-54, 5-56 

Compaq: 5-52, 5-53, 5-54 
cursor control: 7-13 

cursor emulation: 5-28 
cursor position: 5-12, 5-13, 
5-33, 5-67, 15-19, 15-20 
cursor size: 5-12, 5-13, 
5-58, 5-67 

default INT 10h: 5-72 
DESQview: 5-51, 5-52 
Direct Graphics Interface 
Standard: 5-45 

display, updating: 18-1, 
18-2 
display address: 15-1 
display combination code: 
5-32 
display pages: 5-13, 5-33, 
5-37 
display positioning: 5-44 
and DOS extenders: 5-63 
EGA: 5-27 

emulation control: 5-11, 
5-28, 5-49 

Everex: 5-10, 5-49, 5-50 
Frieze: 5-39 

get color: 5-20, 5-22 

get display information: 
5-46 

get info: 5-27, 5-31, 5-48, 
5-53, 5-64 

GO32.EXE: 5-63 

graphics: 5-17, 5-71 
graphics bitmaps: 5-14 
graphics fonts: 8-125 
graphics mode: 5-36 
gray-scaling: 5-23, 5-28, 
5-54 

GSS: 5-72 

Halo88: 5-73 

Hercules GRAFIX—see 
GRAFIX; 5-36 

Hercules: 5-60 

HiColor: 5-23 

IBM PCjr: 5-72 

initial mode: 3-1 

LCD: 5-30, 5-31 





light pen: 5-13, 5-30, 5-34, 
5-46 

magnification: 36-33 
memory addressing: 5-43, 
5-48 

memory paging: 5-49 

mode numbers: 5-1, 5-10, 
5-23, 5-42, 5-47, 5-57, 
5-59, 5-64 

mode setting: 5-1, 5-10, 
5-11, 5-23, 5-36, 5-42, 
5-47, 5-53, 5-54, 5-59, 
5-63, 5-65 

modes: 5-18, 5-33, 5-41, 
5-42, 5-50, 5-52, 5-57, 
5-65, 15-52 

multiple displays: 5-28, 
5-52 

output: 5-16, 5-17, 5-30, 
5-38, 5-66, 5-69, 5-70, 7-14 
paging: 5-14 

Paint Tools: 5-71 

Paradise: 5-11 

parameter tables: 5-71 

PEL mask: 5-22 

print screen: 5-27 

printing graphics: 5-39 

read character: 5-15 

read display: 5-68 

read pixel: 5-17, 5-38 
screen size: 36-34 
scrolling.i. Video FOSSIL 
scrolling: 5-14, 5-15, 5-26, 
5-51, 5-68 

Texas Instruments PC: 4-12 
TopView: 15-1, 15-2, 15-17 
virtual screens: 17-13, 
17-18 


Video 7 VGA 


autoswitching: 5-48 

get display information; 
5-46 

get info: 5-48 
installation check: 5-46 
mode setting: 5-47 


Video 7: 5-73 
Video FOSSIL: 5-64, 5-70 


ANSI support: 5-66 
configuration: 5-66 
cursor: 5-67 

get info: 5-64 

output: 5-66, 5-69, 5-70 
read display: 5-68 
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scrolling: 5-68 
uninstall: 5-70 
video modes: 5-65 

Video mode numbers: 5-1, 5-10, 
5-23, 5-42, 5-47, 5-57, 
5-59, 5-64 

Video modes: 3-1 

Video palette: 5-17 

Video parameters: 5-31 

VIDRAM 
entry point: 15-60, 15-61 
installation check: 15-60 

VINES—see also Banyan 
VINES: 20-9, 22-1 
3270 emulation: 22-7, 
22-21 
canonical names; 22-19 
category criteria block: 
22-20 
enumerate block: 22-20 
error codes: 22-18 
information block: 22-11 
installation check: 22-1 
IPC ports: 22-2 
machine number; 22-1 
mainframe access: 22-7, 
22-21 
message intercept function: 
22-21 
message storage area; 22-21 
messages: 22-20, 22-21 
name verification: 22-19 
names, enumerating: 22-19 
network address: 27-31 
NiceName block: 22-19 
NiceName: 22-19 
notification functions: 22-7 
port record block: 22-18 
ports for service: 22-17, 
22-18 
printer control: 22-17 
registering application: 22-6 
screen: 22-20, 22-21 
semaphores: 22-2 
semaphores: 27-32 
serial number: 22-16 
service categories: 22-20 
services, checking: 22-22 
sockets, closing: 22-5 
sockets, input from: 22-4, 
22-6, 22-7 
sockets, opening: 22-2 
sockets, output to: 22-3 
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StreetTalk: 22-19 
terminal emulation: 22-12 
terminal status area: 22-16 
usernames: 22-18 
version check: 22-22 
Virtual Control Program Inter- 
face—-see VCPI: 10-17 
Virtual device IDs: 14-5 
Virtual display device: 14-5 
Virtual DMA: 12-1 
buffer copy: 12-5 
buffer size: 12-1 
Buffer: 12-4 
error codes: 12-1 
locking: 12-2, 12-3, 12-4 
Scatter/Gather: 12-3, 12-4 
Subfunction 02h: 12-1 
Subfunction 03h; 12-2 
Subfunction 04h: 12-3 
Subfunction 05h: 12-3 
Subfunction 06h: 12-4 
Subfunction 07h: 12-4 
Subfunction 08h: 12-4 
Subfunction 09h: 12-5 
Subfunction OAh: 12-5 
Subfunction OBh: 12-5 
Subfunction 0Ch: 12-6 
Translation: 12-5, 12-6 
Version Check: 12-1 
Virtual machines 
Microsoft Windows: 14-5, 
14-6 
Virtual memory manager 
OS/386: 9-17, 9-18, 9-19 
Phar Lap: 9-8, 9-9, 9-10, 
9-11, 9-12 
Virtual-86 mode: 2-7 
Virus checkers—see anti-virals: 
34-11 
Viruses—see also anti-virals: 
34-1 
"1049"; 34-5 
"1067": 34-3 
"2468": 34-9 
"516": 34-3 
"600": 34-4 
"699": 34-2 
"JOT": 34-2 
"789"; 34-4 
"8-tunes": 34-8 
"905": 34-5 
"948": 34-2 


"Agiplan": 34-2 
"Anarkia": 34-8 
"April 1st EXE": 34-7 
"Armagedon": 34-8 
"Black Monday": 34-10 
"Carioca": 34-4 
"“Datalock": 34-4 
"dBASE": 34-9 
"Diamond-A"; 34-7 
"Diamond-B": 34-7 
"Dir": 34-7 
"Durban": 34-7 
“Dutch-555": 34-1 
"Eddie-2": 34-4 
"Fellowship": 34-6 
"Flip": 34-9 

“Frere Jacques": 34-9 
“Fu Manchu": 34-8 
"G": 34-1 

"GP1": 34-9 
"Invader": 34-2 
"Jerusalem" family: 34-7 
"Jerusalem": 34-8 
“Jerusalem-G": 34-9 
"Justice": 34-2 
"Klaeren": 34-3 
"Lozinsky": 34-2 
"Magnitogorsk": 34-2 
“Mendoza”: 34-8 
"MG": 34-2 
"Micro-128": 34-11 
"MLTI": 34-6 
"Murphy-1"; 34-2 
"“Murphy-2": 34-2 
"Nina"; 34-4 
"Nomenklatura": 34-2 
"Ontario": 34-10 
“Oropax": 34-1 
“Piter": 34-6 
"Plastique": 34-2, 34-3 
"Plastique-2576": 34-3 
"PSQR/1720": 34-10 
"Saddam": 34-11 
"Scott’s Valley": 34-5 
"Shake": 34-2 
"Slow": 34-5 
"Solano": 34-5 
"Spyer": 34-8 
"Stupid": 34-11 
"Sunday": 34-10 
"SVC": 34-3 
"Sverdiov": 34-6 
"Terror": 34-8 

"Tiny" family: 34-10 


"Voronezh": 34-4 
"Vriest": 34-4 
"Westwood": 34-6 
"Yankee": 34-6 
“Zero Bug'': 34-10 
Plastique-2576": 34-2 
unknown functions: 34-3, 
34-5, 34-6, 34-7, 34-10, 34- 
11 

Visual Edge: 30-1 

VMixX: 17-1 
banner message: 17-6 
V/O channels: 17-2, 17-4 
installation check: 17-2 
memory objects: 17-2 
object control block: 17-3 
process control block: 17-3 
process creation: 17-5 
process destruction: 17-5 
process identifiers; 17-3 
processes, active: 17-4 
processes: 17-4 
protected-mode execution: 
17-5 
queues: 17-4, 17-5 
root window: 17-6 
shell: 17-5 
suspending processes: 17-6 
unknown functions: 17-7, 
17-8 
user input: 17-3 
video output: 17-3 
video: 17-6, 17-7 
vprintf: 17-3 

Volume label: 8-24, 8-28, 8-36, 
8-44, 8-68, 8-89, 8-90, 
8-91, 8-120, 8-121, 8-122, 
8-123 

Vprintf: 17-3 

VROOMM: 35-3 

VUIMAGE: 5-18 

VxD 
IDs: 14-5 


Wagner, Thomas: 17-1, 17-10 
Wait intervals: 3-8, 3-9 
WATCH.COM: 36-76 

installation check: 36-76 
Watchdog timers: 3-16 
Waterloo Microsystems: 27-12 
WCED: 36-76 

installation check: 36-77 





Weaver, Mike: 15-55 

Weitek coprocessor: 3-2 

Wentworth, Ross Neilson: 36-52 

Western Digital: 6-4 

WHOA!,.COM: 36-77 
installation check: 36-77 
slowdown; 36-77 
uninstall: 36-77 

Wildcards: 8-7, 8-8, 8-9, 8-10, 
8-13, 8-16, 8-27, 8-44, 
8-64, 8-70, 8-73, 8-77, 
8-132 

WILDUNIX: 36-77 


installation check: 8-140 


XMS: 10-1 


entry point: 10-1 
installation check: 10-1 


Yes-no response: 8-87 


Z100 


keyboard interrupt: 2-9 
light pen: 2-9 

master 8259: 2-9, 2-10 
parity error: 2-9 
printer: 2-10 


installation check: 36-77 processor swap: 2-9 


Windows—see also Microsoft 3-11 
Windows: 41 serial interrupts: 2-9 
instance items: 14-3 slave 8259; 2-9, 2-10, 2-11 
startup information struc- timer: 2-9 
_ ture: 14-2 warm boot: 4-12 
WinOldAp: 14-5, 14-6 Zenith: 4-12 
clearing cliboard: 14-7 Z.100—see 2100; 4-12 
clipboard: 14-7, 14-8, 14-9 Zenith AT:4-12 
clipboard data: 14-8 ZIPKEY: 32-1 


closing cliboard: 14-8 4 +39 S 
compacting clipboard: 14-9 eines A : 
device capabilities: 14-9, hotkeys: 32-5 


14-10 : 4 
‘ 4 . installation check; 32-1 
pie oe index keyboard stuffing: 32-3 





popup: 32-4 

state codes: 32-1, 32-2 
state names: 32-2 
version check; 32-1 
ZIP code lookup: 32-2, 


opening cliboard: 14-7 
version check: 14-6 
WinQVTNet: 27-36 
Word Perfect: 36-78 


Third-Party Interface instal- 32.3 
_ lation check: 36-78 ZIP code output: 32-2 
Writing files: 8-27 ZIP code regions: 32-4 
Writing strings: 8-4 ZSoft: 5-39 


Zubeldia, Kepa: 36-32 
X.25: 27-20, 27-38 
X00 
fake input: 7-18 
input: 7-18 
status: 7-17 
XBDA: 3-14 
XBRK structure: 9-1 
XDI drivers—see also External 
Device Interface: 15-54 
installation check: 15-55 
XDV 
installation check: 15-43 
XMA2EMS.SYS: 8-140 


$100 vectored lines: 2-10, 
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INTERRUPTS 


A PROGRAMMER’S REFERENCE TO BIOS, DOS, AND THIRD-PARTY CALLS 





s is the first and only complete reference to all the system calls an IBM programmer will 
feed — MS-DOS”, the ROM BIOS, and various APIs (application program interfaces) such as Windows™ 
3.0, NetWare”, and DESQview™. Over 25 major APIs, dozens of resident utilities, as well as BIOS and 
MS-DOS services are covered. Designed for ease of reference, provides programmers 
with a concise description and other essential information on each call. In addition, the book is the 
only available source of information on potential conflicts between calls from different APIs, 


The book includes complete coverage of the following interrupt services and topics: 


* ROM BIOS ° Hardware and video 

* Multitaskers * Low-level and serial 1/0 

© DPMI * Microsoft Windows and Novell NetWare 
* Networking calls * DOS extenders 


is an essential resource for all PC programmers using system calls. 


is a Ph.D. candidate in the School of Computer Science at Carnegie Mellon U niversity. 
He maintains the well-known on-line “Interrupt List,” and . = 
coauthored Undocumented DOS (Addison-Wesley, 1990). PSU BOOKSTORE jf 


. - DEPT/CLASS 230010 — 
is on the graphics development staff at Norick Software. _ SECTION/TOPIC 2300 
A professional writer, he also coauthored Undocumented DOS. 
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